CMapStringToOb::Lookup

Article
03/04/2013

Retourne un pointeur d' CObject selon une valeur d' CString .

BOOL Lookup(
   LPCTSTR key,
   CObject*& rValue 
) const;

Paramètres

key
Spécifie la clé de chaîne qui identifie l'élément à rechercher.
rValue
Spécifie la valeur retournée par l'élément regardé).

Valeur de retour

Une valeur différente de zéro si l'élément a été trouvé ; sinon 0.

Notes

Lookup utilise un algorithme de hachage pour rechercher rapidement l'élément de la table avec une clé qui correspond exactement à (valeur d'CString ).

Le tableau suivant indique les autres fonctions membres similaires à CMapStringToOb::LookUp.

Classe	Fonction membre
CMapPtrToPtr	BOOL Lookup( void* key, void& rValue ) const;*
CMapPtrToWord	BOOL Lookup( void* key, WORD& rValue ) const;
CMapStringToPtr	BOOL Lookup( LPCTSTR key, void& rValue ) const;*
CMapStringToString	BOOL Lookup( LPCTSTR key, CString& rValue ) const;
CMapWordToOb	BOOL Lookup( WORD key, CObject& rValue ) const;*
CMapWordToPtr	BOOL Lookup( WORD key, void& rValue ) const;*

Exemple

Consultez CObList::CObList pour obtenir l'intégralité de la classe d' CAge utilisée dans les exemples de collection.

CMapStringToOb map;
CAge* pa;

map.SetAt(_T("Bart"), new CAge(13));
map.SetAt(_T("Lisa"), new CAge(11));
map.SetAt(_T("Homer"), new CAge(36));
map.SetAt(_T("Marge"), new CAge(35));
ASSERT(map.Lookup(_T("Lisa"), (CObject*&)pa)); // Is "Lisa" in the map?
ASSERT(*pa ==  CAge(11)); // Is she 11?