CObList::AddHead

Syntax

POSITION AddHead( CObject* newElement )
throw( CMemoryException );

void AddHead( CObList* pNewList )
throw( CMemoryException );

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.

Remarks

Adds a new element or list of elements to the head of this list. The list may be empty before the operation.

Return Value

The first version returns the POSITION value of the newly inserted element.

Example

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 << "AddHead example: " << &list << "\\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