This topic has not yet been rated Rate this topic

CObList::AddHead

Visual Studio 2010

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

Copy

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

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 );

Remarks

The list can be empty before the operation.

Example

See CObList::CObList for a listing of the CAge class.

C++

Copy


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