Classe de CMap

Une classe de collection de dictionnaires qui mappe des clés uniques aux valeurs.

template< class KEY, class ARG_KEY, class VALUE, class ARG_VALUE >class CMap : public CObject

Paramètres

• KEY
  Classe de l'objet utilisé comme clé dans le mappage.

• ARG*_*KEY
  Type de données utilisé pour les arguments d' KEY ; généralement une référence à KEY.

• VALUE
  Classe de l'objet stocké dans le mappage.

• ARG*_*VALUE
  Type de données utilisé pour les arguments d' VALUE ; généralement une référence à VALUE.

Membres

Structures publiques

Nom	Description
CMap::CPair	Une structure imbriquée qui contient une valeur de clé et la valeur de l'objet associé.

Constructeurs publics

Nom	Description
CMap::CMap	Construit une collection qui mappe les clés en valeurs.

Méthodes publiques

Nom	Description
CMap::GetCount	Retourne le nombre d'éléments dans ce mappage.
CMap::GetHashTableSize	Retourne le nombre d'éléments dans la table de hachage.
CMap::GetNextAssoc	Obtient l'élément pour itérer.
CMap::GetSize	Retourne le nombre d'éléments dans ce mappage.
CMap::GetStartPosition	Retourne la position du premier élément.
CMap::InitHashTable	Initialise la table de hachage et spécifie sa taille.
CMap::IsEmpty	Tests de l'état de vide- aucun mappage (éléments).
CMap::Lookup	Recherche la valeur mappée à une clé donnée.
CMap::PGetFirstAssoc	Retourne un pointeur vers le premier élément.
CMap::PGetNextAssoc	Obtient un pointeur vers l'élément pour itérer.
CMap::PLookup	Retourne un pointeur vers une clé dont la valeur correspond à la valeur spécifiée.
CMap::RemoveAll	Supprime tous les éléments de ce mappage.
CMap::RemoveKey	Supprime un élément spécifié par une clé.
CMap::SetAt	Insère un élément dans le mappage ; remplace un élément existant si une clé correspondante est trouvée.

Opérateurs publics

Nom	Description
CMap::operator []	Insère un élément dans le mappage de remplacement d'opérateur pour SetAt.

Notes

Une fois que vous avez inséré une paire clé-valeur (élément) dans le mappage, vous pouvez récupérer ou supprimer efficacement les paires à l'aide de la clé pour y accéder.Vous pouvez également itérer au sein de tous les éléments dans le mappage.

Une variable de type position est utilisée pour l'autre accès aux entrées.Vous pouvez utiliser position « vous souvenez » une entrée et pour itérer mappage.Vous pouvez penser que cette itération est séquentielle par valeur de clé ; il n'est pas.La séquence d'éléments récupérés est indéterminée.

Certaines fonctions membres de cette classe appelle les fonctions d'assistance globales qui doivent être personnalisées pour la plupart des fonctionnalités de la classe d' CMap .Consultez programmes d'assistance de classe de collection dans la section de macros et Globals d' MFCReference.

CMap remplace CObject::Serialize pour prendre en charge la sérialisation et faire un dump de ses éléments.Si un mappage est stockée à une archive à l'aide de Serialize, chaque élément du tableau est sérialisé après.L'implémentation par défaut de la fonction d'assistance d' SerializeElements fait de bits un écrire.Pour plus d'informations sur la sérialisation des éléments de collection de pointeur dérivés d' CObject ou d'autres types définis par l'utilisateur, consultez Comment : Effectuez une collection de type sécurisé.

Si vous avez besoin d'un dump de diagnostic des éléments individuels dans le mappage (les clés et les valeurs), vous devez définir la profondeur du contexte de dump à 1 ou supérieur.

Lorsqu'un objet d' CMap est supprimé, ou lorsque ses éléments sont supprimés, les clés et les valeurs les deux sont supprimées.

La dérivation de classe de mappage est semblable à la dérivation de liste.Consultez l'article collections pour une illustration de dériver d'une classe ayant un usage spécial de liste.

Hiérarchie d'héritage

CObject

CMap

Configuration requise

Header: afxtempl.h

Voir aussi

Référence

Classe de CObject

Graphique de la hiérarchie

Concepts

L'exemple MFC COLLECTENT