CList::InsertBefore

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

更新 : 2007 年 11 月

リスト内の指定した位置の要素の直前に要素を追加します。

POSITION InsertBefore(
   POSITION position,
      ARG_TYPE newElement 
);

パラメータ

position
直前の GetNext、GetPrev、Find メンバ関数の呼び出しで返された POSITION 値。
ARG_TYPE
リスト要素の型を指定するテンプレートパラメータ (参照でもかまいません)。
newElement
リストに追加する要素。

戻り値

順次アクセス時やリスト要素の取得時に使う POSITION 値を返します。

解説

position が NULL の場合、要素はリストの先頭に挿入されます。

使用例

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

// Add three elements to the list.
POSITION pos = myList.AddHead(CString(_T("XYZ")));
pos = myList.InsertBefore(pos, CString(_T("ABC")));
pos = myList.InsertBefore(pos, CString(_T("123")));

// Verify the head element is what's expected.
ASSERT(CString(_T("123")) == myList.GetHead());