CList::InsertBefore

POSITIONInsertBefore(POSITIONposition**,ARG_TYPEnewElement);**

Return Value

A POSITION value that can be used for iteration or list element retrieval; NULL if the list is empty.

Parameters

position

A POSITION value returned by a previous GetNext, GetPrev, or Find member function call.

ARG_TYPE

Template parameter specifying the type of the list element (can be a reference).

newElement

The element to be added to this list.

Remarks

Adds an element to this list before the element at the specified position.

Example

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

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

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

CList Overview |  Class Members |  Hierarchy Chart

See Also   CList::Find, CList::InsertAfter