CMapStringToOb::Lookup

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

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

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

パラメータ

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

戻り値

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

解説

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

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

クラス	メンバ関数
CMapPtrToPtr	BOOL Lookup( voidkey, void&rValue ) const;
CMapPtrToWord	BOOL Lookup( voidkey, WORD&rValue ) const;*
CMapStringToPtr	BOOL Lookup( LPCTSTRkey, void&rValue ) const;*
CMapStringToString	BOOL Lookup( LPCTSTRkey, CString&rValue ) const;
CMapWordToOb	BOOL Lookup( WORDkey, CObject&rValue ) const;*
CMapWordToPtr	BOOL Lookup( WORDkey, 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?