CList::InsertBefore

2011-08-09

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

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());