CList::SetAt

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

更新 : 2007 年 11 月

POSITION 型の変数はリストのキーとして使用されます。

void SetAt(
   POSITION pos,
      ARG_TYPE newElement 
);

パラメータ

pos
設定する要素の POSITION。
ARG_TYPE
リスト要素の型を指定するテンプレートパラメータ (参照でもかまいません)。
newElement
リストに追加する要素。

解説

インデックスとは異なり、POSITION 値は直接操作できません。SetAt 関数が、リスト内の指定された位置の要素を上書きします。

POSITION 値がリスト内の正しい位置を指していることを確認する必要があります。この値が無効な場合は、MFC ライブラリのデバッグ環境ではアサートされます。

使用例

// Define myList.
CList<CString,CString&> myList;

// Add three elements to the list.
myList.AddTail(CString(_T("XYZ")));
myList.AddTail(CString(_T("ABC")));
myList.AddTail(CString(_T("123")));

// Replace CString("ABC") with CString("CBA")
POSITION pos = myList.Find(CString(_T("ABC")));
myList.SetAt(pos, CString(_T("CBA")));

// Verify CString("ABC") is not in the list.
ASSERT(myList.Find(CString(_T("ABC"))) == NULL);