CObList::AddHead
Adds a new element or list of elements to the head of this list.
POSITION AddHead(
CObject* newElement
);
void AddHead(
CObList* pNewList
);
Parameters
newElement
The CObject pointer to be added to this list.pNewList
A pointer to another CObList list. The elements in pNewList will be added to this list.
Return Value
The first version returns the POSITION value of the newly inserted element.
The following table shows other member functions that are similar to CObList::AddHead.
Class |
Member Function |
|---|---|
POSITION AddHead( void* newElement ); void AddHead( CPtrList* pNewList ); |
|
POSITION AddHead(const CString& newElement ); POSITION AddHead(LPCTSTR newElement ); void AddHead(CStringList* pNewList ); |
Remarks
The list can be empty before the operation.
Example
See CObList::CObList for a listing of the CAge class.
CObList list;
list.AddHead(new CAge(21)); // 21 is now at head.
list.AddHead(new CAge(40)); // 40 replaces 21 at head.
#ifdef _DEBUG
afxDump.SetDepth(1);
afxDump << _T("AddHead example: ") << &list << _T("\n");
#endif
The results from this program are as follows:
AddHead example: A CObList with 2 elements
a CAge at $44A8 40
a CAge at $442A 21
Requirements
Header: afxcoll.h