CTypedPtrList::GetNext
更新 : 2007 年 11 月
rPosition が示す位置のリスト要素を取得します。その後、リストの次のエントリを示す POSITION 値を rPosition に設定します。
TYPE& GetNext(
POSITION& rPosition
);
TYPE GetNext(
POSITION& rPosition
) const;
パラメータ
TYPE
リストに格納されている要素の型を指定するテンプレート パラメータ。rPosition
直前の GetNext、GetHeadPosition、またはほかのメンバ関数の呼び出しで返された POSITION 値への参照。
戻り値
リストが const CTypedPtrList へのポインタを使ってアクセスされた場合、GetNext 関数はテンプレート パラメータ TYPE で指定された型のポインタを返します。このとき、この関数は代入ステートメントの右辺にしか使用できないため、リストは変更されません。
リストが直接または CTypedPtrList へのポインタを使ってアクセスされた場合、GetNext 関数はテンプレート パラメータ TYPE で指定された型のポインタへの参照を返します。このとき、この関数は代入ステートメントの右辺にも左辺にも使用できるので、リストのエントリを変更できます。
解説
GetHeadPosition 関数または CPtrList::Find 関数を呼び出して初期位置を決定すると、前方検索ループで GetNext 関数を使用できます。
POSITION 値がリスト内の正しい位置を指していることを確認する必要があります。この値が無効な場合は、MFC ライブラリのデバッグ環境ではアサートされます。
取得した要素がリストの最後の要素の場合、rPosition の新しい値に NULL が設定されます。
順次アクセス中に要素を削除することもできます。「CObList::RemoveAt 」の例を参照してください。
必要条件
ヘッダー : afxtempl.h