CObList::AddHead

Switch View :

ScriptFree

MFC Library Reference

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
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.

Visual C++

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

Reference

CObList Class

Hierarchy Chart

CObList::GetHead

CObList::RemoveHead

Other Resources

CObList Members