CAtlList::GetNext
更新 : 2007 年 11 月
リストの次の要素を返します。
E& GetNext(
POSITION& pos
) throw( );
const E& GetNext(
POSITION& pos
) const throw( );
パラメータ
- pos
GetNext、CAtlList::GetHeadPosition などの以前の CAtlList メソッドの呼び出しで返された POSITION 値。
戻り値
リストが const の場合、GetNext 関数はリストの要素のコピーを返します。このとき、このメソッドは代入ステートメントの右辺にしか使えないので、リストは変更されません。
const 以外のリストの場合は、GetNext 関数はリストの要素への参照を返します。このとき、このメソッドは代入ステートメントの右辺にも左辺にも使用できるので、リストのエントリを変更できます。
解説
リスト内の次の要素を指すように、POSITION カウンタ pos を更新します。または、次の要素が存在しない場合は、NULL を設定します。デバッグ ビルドでは、pos が NULL である場合にアサーション エラーが発生します。
使用例
「CAtlList::GetHeadPosition」の例を参照してください。
必要条件
ヘッダー : atlcoll.h