Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄CObList►                                     ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  POSITION FindIndex( int nIndex ) const;
 
  Parameter   Description
 
  <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►
 
 
                                     -♦-