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

Remarks

The list can be empty before the operation.

Example

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

Requirements

Header: afxcoll.h

See Also

Concepts

CObList Class

CObList Members

Hierarchy Chart

CObList::GetHead

CObList::RemoveHead