CObList::AddHead

Статья
10/16/2008

Adds a new element or list of elements to the head of this list.

POSITION AddHead(
   CObject* newElement 
);
void AddHead(
   CObList* pNewList 
);

Параметры

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.

Возвращаемое значение

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
CPtrList	POSITION AddHead( void* newElement ); void AddHead( CPtrList* pNewList );
CStringList	POSITION AddHead(const CString& newElement ); POSITION AddHead(LPCTSTR newElement ); void AddHead(CStringList* pNewList );

CPtrList

POSITION AddHead( void* newElement );

void AddHead( CPtrList* pNewList );

CStringList

POSITION AddHead(const CString& newElement );

POSITION AddHead(LPCTSTR newElement );

void AddHead(CStringList* pNewList );

Заметки

The list can be empty before the operation.

Пример

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