This documentation is archived and is not being maintained.

CList::Find 

Searches the list sequentially to find the first element matching the specified searchValue.


POSITION Find(
      ARG_TYPE searchValue,
   POSITION startAfter = NULL
) const; 

Parameters

ARG_TYPE

Template parameter specifying the type of the list element (can be a reference).

searchValue

The value to be found in the list.

startAfter

The start position for the search. If no value is specified, the search begins with the head element.

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

// Define myList.
CList<CString,CString&> myList;

// Add three elements to the list.
myList.AddHead(CString("XYZ"));
myList.AddHead(CString("ABC"));
myList.AddHead(CString("123"));

// Find a specific element.
POSITION pos = myList.Find(CString("XYZ"));
ASSERT(CString("XYZ") == myList.GetAt(pos));
Show: