CMapStringToOb::RemoveKey

Article
03/04/2013

Recherche l'entrée de mappage correspondant à la clé fournie ; ensuite, si la clé est trouvée, supprime l'entrée.

BOOL RemoveKey(
   LPCTSTR key 
);

Paramètres

key
Spécifie la chaîne utilisée pour rechercher de mappage.

Valeur de retour

Une valeur différente de zéro si l'entrée a été trouvée et correctement supprimée ; sinon 0.

Notes

Cela peut entraîner des fuites de mémoire si l'objet d' CObject n'est pas supprimé ailleurs.

Le tableau suivant indique les autres fonctions membres similaires à CMapStringToOb::RemoveKey.

Classe	Fonction membre
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);

Exemple

Consultez CObList::CObList pour obtenir l'intégralité de la classe d' CAge utilisée dans les exemples de collection.

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

Les résultats de ce programme sont les suivantes :

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

Configuration requise

Header: afxcoll.h

Voir aussi

Référence

Classe de CMapStringToOb

Graphique de la hiérarchie

CMapStringToOb::RemoveAll

Partager via