CMapStringToOb::RemoveKey

Dynamic Data sucht nach den Zuordnungseintrag entsprechend der angegebenen Schlüssel; dann wenn der Schlüssel gefunden wird, entfernt den Eintrag.

BOOL RemoveKey( 
   LPCTSTR key  
);

Parameter

• key
  Gibt die Zeichenfolge an, die für Zuordnungssuche verwendet wird.

Rückgabewert

Ungleich 0 (null), wenn der Eintrag gefunden wurde und erfolgreich entfernt; 0 andernfalls.

Hinweise

Dies kann Speicherverluste verursachen, wenn die CObject-Objekt nicht an anderer Stelle gelöscht wird.

In der folgenden Tabelle werden andere Memberfunktionen auf, die mit CMapStringToOb::RemoveKey ähneln.

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

Beispiel

Siehe CObList::CObList für Listen der CAge-Klasse, die in allen Auflistungsbeispielen verwendet wird.

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         

Die Ergebnisse dieses Programms sind, wie folgt:

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

Anforderungen

Header: afxcoll.h

Siehe auch

Referenz

CMapStringToOb-Klasse

Hierarchiediagramm

CMapStringToOb::RemoveAll