Partager via


CList::Find

Recherche la liste séquentielle pour rechercher le premier élément correspondant à searchValuespécifié.

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

Paramètres

  • ARG_TYPE
    Paramètre de modèle spécifiant le type d'élément de liste (peut être une référence).

  • searchValue
    La valeur à rechercher dans la liste.

  • startAfter
    La position de départ de la recherche. Si aucune valeur n'est spécifiée, la recherche démarre avec l'élément principal.

Valeur de retour

Une valeur de position qui peut être utilisée pour l'itération ou la recherche de pointeur d'objet ; NULL si l'objet est introuvable.

Exemple

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

Configuration requise

Header: afxtempl.h

Voir aussi

Référence

CList, classe

Graphique de la hiérarchie

CList::GetNext

CList::GetPrev