CMapStringToOb::Lookup

Artigo
02/25/2013

Retorna um ponteiro de CObject baseado em um valor de CString .

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

Parâmetros

key
Especifica a chave de cadeia de caracteres que identifica o elemento a ser pesquisado.
rValue
Especifica o valor retornado do elemento pesquisado.

Valor de retorno

Diferente de zero se o elemento foi encontrado; se não 0.

Comentários

Lookup usa um algoritmo de hash para localizar o elemento de mapa com uma chave que corresponda exatamente (valor deCString ).

A tabela a seguir mostra outras funções de membro que são semelhantes a CMapStringToOb::LookUp.

Classe	Função de membro
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;*

Exemplo

Consulte CObList::CObList para uma listagem da classe de CAge usada em todos os exemplos de coleção.

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?