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

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

RWTPtrSetIterator<T,C>

形式

#include<rw/tpset.h>
RWTPtrSet<T,C> set;
RWTPtrSetIterator<T,C> itr(set);

標準 C++ ライブラリ依存

注 - RWTPtrSetIterator には標準 C++ ライブラリが必要です。

説明

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

RWTPtrMultiSet に対する反復順序は、コンテナに格納された値に適用されるため、使用する比較子オブジェクトに依存します。

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

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

持続性

なし

例

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

int main(){
   RWTPtrSet<RWCString,less<RWCString> > a;
   RWTPtrSetIterator<RWCString,less<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
Mark
Steve

公開コンストラクタ

RWTPtrSetIterator<T,C>(const RWTPtrSet<T,C>& s);

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

公開メンバー演算子

T*
operator()();

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

RWBoolean
operator++();

自分自身を次の要素に進めます。反復子が取り消された、あるいは作成されたばかりの場合、自分自身は最初の要素を参照します。反復の前に自分自身がセット内の最後の関連付けを参照した場合、自分自身は未定義の値を参照し、FALSE に相当する値を返します。それ以外の場合は、TRUE に相当する値を返します。

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

公開メンバー関数

RWTPtrSet<T,C>*
container() const;

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

T*
key() const;

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

void
reset();
void
reset(RWTPtrSet<T,C>& h);

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