CList::FindIndex

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

リストのインデックスとして nIndex の値を使用します。

POSITION FindIndex(
   INT_PTR nIndex 
) const;

パラメータ

nIndex
検索するリスト要素の位置を 0 から始まるインデックスで指定します。

戻り値

順次アクセス時またはオブジェクトのポインタの取得時に使う POSITION 値を返します。nIndex の値が負である場合、大きすぎる場合は、NULL を返します。

解説

リストの先頭から順番に検索を開始し、n 番目の要素で停止します。

使用例

// Define myList.
CList<CString,CString&> myList;

// Add three elements to the list.
myList.AddTail(CString(_T("XYZ")));
myList.AddTail(CString(_T("ABC")));
myList.AddTail(CString(_T("123")));

// Verify the first element (index 0).
ASSERT(CString(_T("XYZ")) == myList.GetAt(myList.FindIndex(0)));

// Verify the third element (index 2).
ASSERT(CString(_T("123")) == myList.GetAt(myList.FindIndex(2)));