Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Adds an element to this list before the element at the specified position.
POSITION InsertBefore(
POSITION position,
CObject* newElement
);
Parameters
position
A POSITION value returned by a previous GetNext, GetPrev, or Find member function call.newElement
The object pointer to be added to this list.
Return Value
A POSITION value that can be used for iteration or object pointer retrieval; NULL if the list is empty.
The following table shows other member functions that are similar to CObList::InsertBefore.
Class |
Member Function |
|---|---|
POSITION InsertBefore( POSITION position, void* newElement ); |
|
POSITION InsertBefore( POSITION position, const CString& newElement ); POSITION InsertBefore( POSITION position, LPCTSTR newElement ); |
Example
See CObList::CObList for a listing of the CAge class.
CObList list;
POSITION pos1, pos2;
list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
if ((pos1 = list.GetTailPosition()) != NULL)
{
pos2 = list.InsertBefore(pos1, new CAge(65));
}
#ifdef _DEBUG
afxDump.SetDepth(1);
afxDump << _T("InsertBefore example: ") << &list << _T("\n");
#endif
The results from this program are as follows:
InsertBefore example: A CObList with 3 elements
a CAge at $4AE2 40
a CAge at $4B02 65
a CAge at $49E6 21
Requirements
Header: afxcoll.h