CMapStringToOb::RemoveKey

Статья
06/10/2015

Ищет запись сопоставления, соответствующее предоставляемому ключу; затем, если ключ найден, удаляет запись.

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 );

Пример

См. перечисление CObList::CObList для класса CAge, используемого во всех примерах коллекции.

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

Поделиться через