CList::Find

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

更新 : 2007 年 11 月

指定した searchValue と最初に一致する要素をシーケンシャルに検索します。

POSITION Find(
      ARG_TYPE searchValue,
   POSITION startAfter = NULL
) const;

パラメータ

ARG_TYPE
リスト要素の型を指定するテンプレートパラメータ (参照でもかまいません)。
searchValue
リストで検索する値。
startAfter
検索の開始位置を指定します。値を指定しないと、先頭の要素から検索が開始されます。

戻り値

反復処理やオブジェクトポインタの取得のために使用する POSITION 値を返します。オブジェクトが見つからなかった場合は NULL を返します。

使用例

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

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

// Find a specific element.
POSITION pos = myList.Find(CString(_T("XYZ")));
ASSERT(CString(_T("XYZ")) == myList.GetAt(pos));