Partager via


CMapStringToOb::RemoveKey

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

CMapStringToOb, classe

Graphique de la hiérarchie

CMapStringToOb::RemoveAll