CTypedPtrList::GetAt
更新 : 2007 年 11 月
POSITION 型の変数はリストのキーとして使用されます。
TYPE& GetAt(
POSITION position
);
TYPE GetAt(
POSITION position
) const;
パラメータ
TYPE
リストに格納されている要素の型を指定するテンプレート パラメータ。position
直前の GetHeadPosition メンバ関数または Find メンバ関数の呼び出しで返された POSITION 値。
戻り値
リストが const CTypedPtrList へのポインタを使ってアクセスされた場合、GetAt 関数はテンプレート パラメータ TYPE で指定された型のポインタを返します。このとき、この関数は代入ステートメントの右辺にしか使用できないため、リストは変更されません。
リストが直接または CTypedPtrList へのポインタを使ってアクセスされた場合、GetAt 関数はテンプレート パラメータ TYPE で指定された型のポインタへの参照を返します。このとき、この関数は代入ステートメントの右辺にも左辺にも使用できるので、リストのエントリを変更できます。
解説
インデックスとは異なり、POSITION 値は直接操作できません。GetAt 関数は、指定された位置に関連付けられている CObject ポインタを取得します。
POSITION 値がリスト内の正しい位置を指していることを確認する必要があります。この値が無効な場合は、MFC ライブラリのデバッグ環境ではアサートされます。
このインライン関数は、BASE_CLASS**::GetAt** を呼び出します。
必要条件
ヘッダー : afxtempl.h