CMapStringToOb::RemoveKey

搜索映射项与所提供的密钥对应;然后,因此,如果找到键时,移除项。

BOOL RemoveKey(
   LPCTSTR key 
);

参数

  • key
    指定用于映射查找的字符串。

返回值

非零,如果找到该项和已成功移除了;否则为0。

备注

如果 CObject 对象在其他地方,不会删除这可能导致内存泄漏。

下表显示类似于 CMapStringToOb::RemoveKey的其他成员函数。

成员函数

CMapPtrToPtr

BOOL RemoveKey( void* key);

CMapPtrToWord

BOOL RemoveKey( void* key);

CMapStringToPtr

BOOL RemoveKey( LPCTSTR key);

CMapStringToString

BOOL RemoveKey( LPCTSTR key);

CMapWordToOb

BOOL RemoveKey( WORD key);

CMapWordToPtr

BOOL RemoveKey( WORD key);

示例

提供用于所有集合示例的列表 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

要求

Header: afxcoll.h

请参见

参考

CMapStringToOb选件类

层次结构图

CMapStringToOb::RemoveAll