CList::Find

  • 项目

POSITIONFind(ARG_TYPEsearchValue,POSITIONstartAfter**=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