CMapStringToOb::RemoveKey

更新 : 2007 年 11 月

指定されたキーに対応するマップ エントリを検索し、キーが検出された場合はそのエントリを削除します。

BOOL RemoveKey(
   LPCTSTR key 
);

パラメータ

• key
  マップの検索に使う文字列を指定します。

戻り値

エントリが見つかり、削除に成功すると、0 以外を返します。それ以外の場合は、0 を返します。

解説

CObject オブジェクトが削除されないと、メモリ不足を生じることになります。

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

クラス	メンバ関数
CMapPtrToPtr	BOOL RemoveKey( void*key );
CMapPtrToWord	BOOL RemoveKey( void*key );
CMapStringToPtr	BOOL RemoveKey( LPCTSTRkey );
CMapStringToString	BOOL RemoveKey( LPCTSTRkey );
CMapWordToOb	BOOL RemoveKey( WORDkey );
CMapWordToPtr	BOOL RemoveKey( WORDkey );

使用例

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

CMapStringToOb map;

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));
map.RemoveKey(_T("Lisa")); // Memory leak: CAge object not
                           // deleted.
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("RemoveKey example: ") << &map << _T("\n");
#endif         

このプログラムの実行結果は次のようになります。

RemoveKey example: A CMapStringToOb with 3 elements

[Marge] = a CAge at $49A0 35

[Homer] = a CAge at $495E 36

[Bart] = a CAge at $4634 13

必要条件

ヘッダー : afxcoll.h

参照

参照

CMapStringToOb クラス

階層図

CMapStringToOb::RemoveAll

その他の技術情報

CMapStringToOb のメンバ