Share via


CAtlList::GetTailPosition

 

Call this method to obtain the position of the tail of the list.

Syntax

POSITION GetTailPosition( ) const throw( );

Return Value

Returns the POSITION value corresponding to the element at the tail of the list.

Remarks

If the list is empty, the value returned is NULL.

Example

// Define the integer list
CAtlList<int> myList;
int i;

// Populate the list
for (i = 0; i < 100; i++)
{
   myList.AddHead(i);
}

// Get the starting position value
POSITION myP = myList.GetTailPosition();

// Iterate through the entire list
i = 0;
int j;

do {
   j = myList.GetPrev(myP);
   ATLASSERT(i == j);
   i++;
} while (myP != NULL);   

Requirements

Header: atlcoll.h

See Also

CAtlList Class
CAtlList::GetTail
CAtlList::GetHeadPosition