CMapStringToOb::Lookup

[アーティクル]
08/09/2011

CString 値をキーにして、CObject へのポインターを返します。

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

パラメーター

key
検索する要素を識別する文字列キーを指定します。
rValue
見つかった要素の値が返されます。

戻り値

要素が見つかった場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

ハッシュ法を使って、キー (CString 値) と正確に一致するマップの要素をすばやく検索します。

CMapStringToOb::LookUp に類似している他のメンバー関数を以下に示します。

Class	メンバー関数
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;*

使用例

すべてのコレクションの例で使われている CAge クラスのリストについては、CObList::CObList を参照してください。

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?