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
.gif "s897094z.collapse_all(fr-fr,VS.110).gif")
Structures publiques
Nom |
Description |
|---|---|
Une structure imbriquée qui contient une valeur de clé et la valeur de l'objet associé. |
Constructeurs publics
Nom |
Description |
|---|---|
Construit une collection qui mappe les clés en valeurs. |
Méthodes publiques
Nom |
Description |
|---|---|
Retourne le nombre d'éléments dans ce mappage. |
|
Retourne le nombre d'éléments dans la table de hachage. |
|
Obtient l'élément pour itérer. |
|
Retourne le nombre d'éléments dans ce mappage. |
|
Retourne la position du premier élément. |
|
Initialise la table de hachage et spécifie sa taille. |
|
Tests de l'état de vide- aucun mappage (éléments). |
|
Recherche la valeur mappée à une clé donnée. |
|
Retourne un pointeur vers le premier élément. |
|
Obtient un pointeur vers l'élément pour itérer. |
|
Retourne un pointeur vers une clé dont la valeur correspond à la valeur spécifiée. |
|
Supprime tous les éléments de ce mappage. |
|
Supprime un élément spécifié par une clé. |
|
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 |
|---|---|
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
CMap
Configuration requise
Header: afxtempl.h