CObList::AddTail

Syntax

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

void AddTail( 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 tail 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.AddTail( new CAge( 21 ) );

list.AddTail( new CAge( 40 ) ); // List now contains (21, 40)

#ifdef _DEBUG

afxDump.SetDepth( 1 );

afxDump << "AddTail example: " << &list << "\\n";

#endif

The results from this program are as follows:

AddTail example: A CObList with 2 elements

a CAge at $444A 21

a CAge at $4526 40

See Also

CObList::GetTail, CObList::RemoveTail