CAtlList::InsertBefore
Call this method to insert a new element into the list before the specified position.
POSITION InsertBefore(
POSITION pos,
INARGTYPE element
);
Parameters
pos
The new element will be inserted into the list before this POSITION value.element
The element to be inserted.
Return Value
Returns the POSITION value of the new element.
Remarks
In debug builds, an assertion failure will occur if the list isn't valid, if the insert fails, or if an attempt is made to insert the element before the head.
Example
// Define the integer list
CAtlList<int> myList;
// Populate the list
POSITION myPos = myList.AddHead(1);
myPos = myList.InsertBefore(myPos, 2);
myPos = myList.InsertBefore(myPos, 3);
// Confirm the head value is as expected
ATLASSERT(myList.GetHead() == 3);
Requirements
Header: atlcoll.h