CMapStringToOb::Lookup

Artikel
02/26/2013

Gibt einen CObject Zeiger auf Grundlage eines CString-Wert zurück.

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

Parameter

key
Gibt den Zeichenfolgenschlüssel an, der das oben identifiziert gesucht werden, Element.
rValue
Gibt den zurückgegebenen Wert der geschauten-oben Element an.

Rückgabewert

Ungleich 0 (null), wenn das Element gefunden wurde; andernfalls 0.

Hinweise

Lookup verwendet einen Hashalgorithmus, um das Kartenelement mit einem Schlüssel schnell zu suchen, die genau entspricht (CString-Wert).

In der folgenden Tabelle werden andere Memberfunktionen auf, die mit CMapStringToOb::LookUp ähneln.

Klasse	Memberfunktion
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;*

Beispiel

Siehe CObList::CObList für Listen der CAge-Klasse, die in allen Auflistungsbeispielen verwendet wird.

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?