CObList::Find

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

更新 : 2007 年 11 月

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

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

パラメータ

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

戻り値

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

解説

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

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

クラス	メンバ関数
CPtrList	POSITION Find( voidsearchValue, POSITIONstartAfter = NULL ) const;*
CStringList	POSITION Find( LPCTSTRsearchValue, POSITIONstartAfter = 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));
}