Export (0) Print
Expand All

CList::Find

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

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

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(_T("XYZ")));
myList.AddHead(CString(_T("ABC")));
myList.AddHead(CString(_T("123")));

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

Header: afxtempl.h

Show:
© 2014 Microsoft