CObList::FindIndex

Syntax

POSITION FindIndex( int nIndex ) const;

Parameters

nIndex

The zero-based index of the list element to be found.

Remarks

Uses the value of nIndex as an index into the list. It starts a sequential scan from the head of the list, stopping on the nth element.

Return Value

A POSITION value that can be used for iteration or object pointer retrieval; NULL if nIndex is negative or too large.

Example

CObList list;

POSITION pos;

list.AddHead( new CAge( 21 ) );

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

if( ( pos = list.FindIndex( 0 )) != NULL )

{

ASSERT( *(CAge*) list.GetAt( pos ) == CAge( 40 ) );

}

See Also

CObList::Find, CObList::GetNext, CObList::GetPrev