CObList::GetHeadPosition

Gets the position of the head element of this list.

POSITION GetHeadPosition( ) const;

Return Value

A POSITION value that can be used for iteration or object pointer retrieval; NULL if the list is empty.

The following table shows other member functions that are similar to CObList::GetHeadPosition.

Class

Member Function

CPtrList

POSITION GetHeadPosition( ) const;

CStringList

POSITION GetHeadPosition( ) const;

Example

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

CObList list;
POSITION pos;

list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
if ((pos = list.GetHeadPosition()) != NULL)
{
    ASSERT(*(CAge*) list.GetAt(pos) == CAge(40));
}    

Requirements

Header: afxcoll.h

See Also

Reference

CObList Class

Hierarchy Chart

CObList::GetTailPosition

Other Resources

CObList Members