CObList::FindIndex

  • [アーティクル]

更新 : 2007 年 11 月

リストのインデックスとして nIndex の値を使用します。

POSITION FindIndex(
   INT_PTR nIndex 
) const;

パラメータ

  • nIndex
    検索するリスト要素の位置を 0 から始まるインデックスで指定します。

戻り値

順次アクセスやオブジェクトのポインタを取得するのに使う POSITION 値を返します。nIndex の値が大きすぎる場合は NULL を返します。nIndex が負の値の場合は、フレームワークがアサートします。

解説

リストの先頭から順番に検索を開始し、n 番目の要素で停止します。

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

クラス

メンバ関数

CPtrList

POSITION FindIndex( INT_PTRnIndex ) const;

CStringList

POSITION FindIndex( INT_PTRnIndex ) const;

使用例

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

CObList list;
POSITION pos;

list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
if ((pos = list.FindIndex(0)) != NULL)
{
    ASSERT(*(CAge*) list.GetAt(pos) == CAge(40));
}

必要条件

ヘッダー : afxcoll.h

参照

参照

CObList クラス

階層図

CObList::Find

CObList::GetNext

CObList::GetPrev

その他の技術情報

CObList のメンバ