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

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

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

## RWDlistCollectablesIterator

RWDlistCollectablesIterator RWIterator

### 形式

      #include <rw/dlistcol.h>
      RWDlistCollectables d;
      RWDlistCollectablesIterator it(d) ;

### 説明

  クラス RWDlistCollectables の反復子。リンクリストを最初の項目から最後の項目までくまなくたどります。機能は、双方向に作用します。

  すべての Rogue Wave 反復子と同様に、作成直後の "現在の項目" は未定義で、`operator()` または他の有効な操作によって定義する必要があります。

  反復子がコレクションの最後を越えると無効になります。そのまま使用し続けると、予期できない結果をもたらします。

### 持続性

  なし

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

      RWDlistCollectablesIterator (RWDlistCollectables& d);

    RWDlistCollectables から RWDlistCollectablesIterator を作成します。作成直後の反復子の位置は不定です。

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

      virtual RWCollectable*
      operator()();

    クラス RWIterator から再定義した演算子。反復子を次の項目に進め、その項目を返します。リストの最後に達したら NULL を返します。

      void
      operator++();

    反復子を 1 項目進めます。

      void
      operator--();

    反復子を 1 項目戻します。

      void
      operator+=(size_t n);

    反復子を `n` 項目進めます。

      void
      operator-=(size_t n);

    反復子を `n` 項目戻します。

### 公開メンバー関数

      RWBoolean
      atFirst() const;

    反復子がリストの最初にあれば `TRUE` を、それ以外の場合は `FALSE` を返します。

      RWBoolean
      atLast() const;

    反復子がリストの最後にあれば `TRUE` を、それ以外の場合は `FALSE` を返します。

      virtual RWCollectable*
      findNext(const RWCollectable* target);

    クラス RWIterator から再定義した関数。オブジェクト `target` と `isEqual` である項目に反復子を移動し、その項目を返します。等しい項目がない場合は NULL を返し、反復子の位置は不定となります。

      RWCollectable*
      findNextReference(const RWCollectable* e);

    項目 `e` と同一の次の項目 (アドレス `e` を持つ項目) に反復子を移動し、その項目を返します。同一の項目がない場合は NULL を返し、反復子の位置は不定となります。

      RWCollectable*
      insertAfterPoint(RWCollectable* a);

    現在のカーソル位置の後に項目 `a` を挿入し、その項目を返します。カーソル位置は変わりません。

      virtual RWCollectable*
      key() const;

    クラス RWIterator から再定義した関数。現在の反復子の位置にある項目を返します。

      RWCollectable*
      remove();

    現在のカーソル位置にある項目を取り除き、それを返します。その後反復子はリスト内でその前の項目に移動します。

      RWCollectable*
      removeNext(const RWCollectable* target);

    リスト内で項目 `target` と `isEqual` である次の項目に反復子を移動し、その項目をリストから取り除き、それを返します。その後、反復子の位置はリスト内でその前の項目に移動します。等しい項目がない場合は NULL を返し、反復子の位置は不定となります。

      RWCollectable*
      removeNextReference(const RWCollectable* e);

    リスト内で項目 `e` と同一の次の項目 (アドレス `e` を持つ項目) に反復子を移動し、その項目を取り除き、それを返します。その後、反復子の位置はリスト内でその前の項目に移動します。等しい項目がない場合は `nil` を返し、反復子の位置は不定となります。

      virtual void
      reset();

    RWIterator から再定義した関数。反復子をリセットします。その後反復子の位置は不定になります。

      void
      toFirst();

    反復子をリストの最初に移動します。

      void
      toLast();

    反復子をリストの最後に移動します。