CMapStringToOb::Lookup

Artigo
08/25/2010

Retorna um CObject ponteiro com base em um CString valor.

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

Parâmetros

key
Especifica a chave de seqüência de caracteres que identifica o elemento a ser pesquisado.
rValue
Especifica o valor retornado do elemento procurou-up.

Valor de retorno

Diferente de zero se o elemento foi localizado; caso contrário, 0.

Comentários

Lookup usa um algoritmo de hash para localizar rapidamente o elemento do MAP com uma chave que corresponda exatamente)CString valor).

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

Classe	Função de membro
CMapPtrToPtr	Pesquisa BOOL (void * key, void& rValue ) Const;*
CMapPtrToWord	Pesquisa BOOL (void * key, palavra& rValue ) Const;
CMapStringToPtr	Pesquisa BOOL (LPCTSTR key, void& rValue ) Const;*
CMapStringToString	Pesquisa BOOL (LPCTSTR key, CString & rValue ) Const;
CMapWordToOb	Pesquisa BOOL (palavra key, CObject * & rValue ) Const;
CMapWordToPtr	Pesquisa BOOL (palavra key, void& rValue ) Const;*

Exemplo

See CObList::CObList para obter uma lista do CAge classe 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?