POSITION Find( ARG_TYPE searchValue, POSITION startAfter = NULL) const;
Return Value
A POSITION value that can be used for iteration or object pointer retrieval; NULL if the object is not found.
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.
Remarks
Searches the list sequentially to find the first element matching the specified searchValue. Note that the pointer values are compared, not the contents of the objects.
Example
// 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));
CList Overview | Class Members | Hierarchy Chart
See Also CList::GetNext, CList::GetPrev