CObList::Find

2011-08-09

指定した CObject のポインターと一致するリスト上で最初の CObject のポインターを順番に検索します。

POSITION Find(
   CObject* searchValue,
   POSITION startAfter = NULL 
) const;

パラメーター

searchValue
リスト内で検索するオブジェクトのポインターを指定します。
startAfter
検索の開始位置を指定します。

戻り値

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

解説

オブジェクトの内容を比較するのではなく、ポインター値を比較します。

CObList::Find に類似している他のメンバー関数を以下に示します。

Class	メンバー関数
CPtrList	POSITION Find( void* searchValue, POSITION startAfter = NULL ) const;
CStringList	POSITION Find( LPCTSTR searchValue, POSITION startAfter = NULL ) const;

使用例

CAge クラスのリストについては、「CObList::CObList」を参照してください。

CObList list;
CAge* pa1;
CAge* pa2;
POSITION pos;
list.AddHead(pa1 = new CAge(21));
list.AddHead(pa2 = new CAge(40));    // List now contains (40, 21).
if ((pos = list.Find(pa1)) != NULL) // Hunt for pa1
{                                  // starting at head by default.
    ASSERT(*(CAge*) list.GetAt(pos) == CAge(21));
}