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

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

RWTValMapIterator<K,T,C>

形式 

#include<rw/tvmap.h>
RWTValMap<K,T,C> vm;
RWTValMapIterator<K,T,C> itr(vm);

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

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

説明

Tools.h++ 7 の RWTValMapIterator には、Tools.h++ 6.x に付属するコンテナ反復子との下位互換性を持つ RWTValMapIterator への反復子インタフェースが用意されています。

RWTValMap に対する繰り返し順序は、格納された関連付けのキー値に適用されるため、使用する比較子オブジェクトに依存します。

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

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

持続性

なし

例 

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

int main(){
   RWTValMap<RWCString,int,greater<RWCString> > age;
   RWTValMapIterator<RWCString,int,greater<RWCString> >
itr(age);

   age.insert("John", 30);
   age.insert("Steve",17);
   age.insert("Mark",24);

//挿入が拒絶され、重複は不可
   age.insert("Steve",24);

   for(;itr();)
     cout << itr.key() << "\'s age is " << itr.value() << endl;

   return 0;
}

プログラム出力 

Steve's age is 17
Mark's age is 24
John's age is 30

公開コンストラクタ 

RWTValMapIterator<K,T,C>
(RWTValMap<K,T,C>&h);

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

公開メンバー演算子 

RWBoolean
operator()();

自分自身を次の要素に進めます。反復子がコレクション内の最後の要素を越えた場合は、FALSE を返します。それ以外の場合は、TRUE を返します。 

RWBoolean
operator++();

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

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

公開メンバー関数 

RWTValMap<K,T,C>*
container() const;

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

K
key() const;

現在自分自身が参照している関連付けのキー部分を返します。 

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

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

T
value();

自分自身が参照する関連付けの値部分を返します。