Tools.h++ 7.0 クラスライブラリ・リファレンスマニュアル: RWTPtrSlistIterator

バナーをクリックすれば目次に戻ります

Copyright 1999 Rogue Wave Software
Copyright 1999 Sun Microsystems, Inc.

## RWTPtrSlistIterator<T>

### 形式

      #include<rw/tpslist.h>
      RWTPtrSlist<T> dl;
      RWTPtrSlistIterator<T> itr(dl);

  > 注 - 標準 C++ ライブラリがある場合は、ここで述べるインタフェースを使用します。標準 C++ ライブラリがない場合は、付録 A に記載する RWTPtrSlistIterator に限定されたインタフェースを使用してください。

### 説明

  Tools.h++ 7 の RWTPtrSlistIterator には、Tools.h++ 6.x に付属するコンテナ反復子との下位互換性を持つ、新しい標準ライブラリにもとづくコレクションへの反復子インタフェースが用意されています。

  RWTPtrSlist に対する反復順序は、コンテナに項目が挿入された順序に依存します。

  この反復子が参照する現在の項目は、作成後も、`reset()` の呼び出し後も定義されていません。反復子は、前置インクリメントか `operator()` を用いて進められた後に有効になります。

  `operator++` と `operator()` の場合は、最後の要素を越えて反復すると、ブール型の `FALSE` に相当する値を返します。このまま増分し続けると、`reset()` が呼び出されるまで、`FALSE` に相当する値を返します。

  Slist に変更を加えると、すべての反復子は無効になります。

### 持続性

  なし

### 例

      #include<rw/tpslist.h>
      #include<iostream.h>
      #include<rw/cstring.h>

      int main(){
         RWTPtrSlist<RWCString> a;
         RWTPtrSlistIterator<RWCString> itr(a);
         a.insert(new RWCString("John"));
         a.insert(new RWCString("Steve"));
         a.insert(new RWCString("Mark"));
         a.insert(new RWCString("Steve"));

         for(;itr();)
           cout << *itr.key() <<endl;

         return 0;
      }

  #### プログラム出力

      John
      Steve
      Mark
      Steve

### 公開コンストラクタ

      RWTPtrSlistIterator<T>(RWTPtrSlist<T>& lst);

    リスト `lst` の反復子を作成します。反復子は、未定義状態から始まり、最初の要素がアクセス可能になる前まで進める必要があります。

### 公開メンバー演算子

      T*
      operator()();

    自分自身を次の要素に進め、結果反復子を間接参照し、その値を返します。反復子がコンテナ内の最後の項目を越えた場合は、ブール型の `FALSE` に相当する NULL ポインタの要素を返します。

      RWBoolean
      operator++();

    自分自身を次の要素に進めます。反復子が初期状態に戻された、あるいは作成されたばかりの場合、自分自身は最初の要素を参照します。反復の前に自分自身がリスト内の最後の関連付けを参照した場合、自分自身は (初期状態値とは異なる) 未定義の値を参照し、`FALSE` に相当する値を返します。それ以外の場合は、`TRUE` に相当する値を返します。

  > 注 - 後置インクリメント演算子は提供されていません。

      RWBoolean
      operator+=(size_type n);

    `operator++` メンバー関数が `n` 回適用されたのと同様に機能します。

### 公開メンバー関数

      RWTPtrSlist<T>*
      container() const;

    反復されるコレクションへのポインタを返します。

      T*
      findNext(const T* a);

    自分自身を順方向に反復することによって遭遇する、式 `(*t == *a)` が `TRUE` になるような最初の要素 `t` を返します。そのような要素が見つからない場合は、NULL を返します。自分自身に見つけた項目を参照させておくか、「終端を越えた」にしておきます。

      T*
      findNext(RWBoolean(*fn)(T*, void*), void* d);

    自分自身を順方向に反復することによって遭遇する、式 `((*fn)(t,d))` が `TRUE` になるような最初の要素 `t` を返します。`fn` が指すユーザー定義テスター関数は、次のプロトタイプを持っていなければなりません。

         bool yourTester(const T* a, void* d);

    クライアントデータは、パラメタ `d` を通して渡すことができます。

      void
      insertAfterPoint(T* p);

    自分自身が指す要素の直後のコンテナにポインタ `p` 挿入します。自分自身を以前の項目を参照したままにするか、`reset` 状態にしたままにしておきます。

      T*
      key();

    自分自身が指す格納された値を返します。自分自身がリスト内の値を参照していない場合の影響は定義されていません。

      T*
      remove();

    自分自身が参照する格納された値を返し、その値をコレクションから削除します。自分自身がリスト内の値を参照していない場合の影響は定義されていません。自分自身を直前の項目を参照したままにするか、初期状態に戻します。

      T*
      removeNext(const T*);

    自分自身を順方向に反復することによって遭遇する、式 `(*t == *a)` が `TRUE` になるような最初の要素 `t` を返して削除します。自分自身を直前の項目を参照したままにするか、初期状態に戻します。

      T*
      removeNext(RWBoolean(*fn)(T*, void*), void* d);

    自分自身を順方向に反復することによって遭遇する、式 `((*fn)(t,d))` が `TRUE` になるような最初の要素 `t` を返して削除します。`fn` が指すユーザー定義テスター関数は、次のプロトタイプを持っていなければなりません。

         bool yourTester(const T* a, void* d);

    クライアントデータは、パラメタ `d` を通して渡すことができます。自分自身を直前の項目を参照したままにするか、初期状態に戻します。

      void
      reset();
      void
      reset(RWTPtrSlist<T>& l);

    次に、前に進められた反復子がコレクションの最初の要素を参照できるように、反復子を初期状態に戻します。引数なしで `reset()` を使用すると、現在のコンテナ上の反復子が初期状態に戻されます。`reset()` に RWTPtrSlist を使用すると、その新しいコンテナ上の反復子が初期状態に戻されます。