CList::Find

Sucht die Liste sequenziell, das erste Element zu suchen, das angegebene searchValue übereinstimmt.

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

Parameter

  • ARG_TYPE
    Vorlagenparameter, der den Typ des Listenelements angibt (sein kann ein Verweis).

  • searchValue
    Der in der Liste gefunden werden, Wert.

  • startAfter
    Die Anfangsposition für die Suche.Wenn kein Wert angegeben ist, startet die Suche mit dem Anfangselement.

Rückgabewert

Ein Wert, der POSITION für Iteration oder Objektzeigerabruf verwendet werden kann, NULL, wenn das Objekt nicht gefunden wird.

Beispiel

// 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));      

Anforderungen

Header: afxtempl.h

Siehe auch

Referenz

CList-Klasse

Hierarchien-Diagramm

CList::GetNext

CList::GetPrev