CAtlList::Find
更新 : 2007 年 11 月
指定した要素についてリストを検索します。
POSITION Find(
INARGTYPE element,
POSITION posStartAfter = NULL
) const throw( );
パラメータ
element
リストで検索する要素。posStartAfter
検索の開始位置。値を指定しないと、先頭の要素から検索が開始されます。
戻り値
要素が見つかった場合は POSITION 値を返します。それ以外の場合は NULL を返します。
解説
デバッグ ビルドでは、リスト オブジェクトが無効な場合、または posStartAfter 値が範囲外の場合に、アサーション エラーが発生します。
使用例
// Define the integer list
CAtlList<int> myList;
// Populate the list
myList.AddTail(100);
myList.AddTail(200);
myList.AddTail(300);
myList.AddTail(400);
// Find the '300' element in the list,
// starting from the list head.
POSITION myPos = myList.Find(300);
// Confirm that the element was found
ATLASSERT(myList.GetAt(myPos) == 300);
必要条件
ヘッダー : atlcoll.h