次の方法で共有


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

参照

参照

CAtlList クラス

CAtlList::FindIndex

その他の技術情報

CAtlList のメンバ