Partager via


CSimpleMap, classe

Cette classe fournit la prise en charge d'un tableau de mappage simple.

template <  
   class TKey, 
   class TVal, 
   class TEqual = CSimpleMapEqualHelper< TKey, TVal >  
>  
class CSimpleMap

Paramètres

  • TKey
    Le type d'élément clé.

  • TVal
    Le type d'élément de valeur.

  • TEqual
    Un objet de fonctionnalités, en définissant le test d'égalité pour les éléments de type T.

Membres

Typedefs publics

Nom

Description

CSimpleMap::_ArrayElementType

Typedef pour le type valeur.

CSimpleMap::_ArrayKeyType

Typedef pour le type de clé.

Constructeurs publics

Nom

Description

CSimpleMap::CSimpleMap

Constructeur.

CSimpleMap::~CSimpleMap

Le destructeur.

Méthodes publiques

Nom

Description

CSimpleMap::Add

Ajoute une clé et une valeur associée au tableau de mappage.

CSimpleMap::FindKey

Recherche une clé spécifique.

CSimpleMap::FindVal

Recherche une valeur spécifique.

CSimpleMap::GetKeyAt

Extrait la clé spécifiée.

CSimpleMap::GetSize

Retourne le nombre d'entrées dans la table de mappage.

CSimpleMap::GetValueAt

Extrait la valeur spécifiée.

CSimpleMap::Lookup

Retourne la valeur associée à la clé spécifiée.

CSimpleMap::Remove

Supprime une clé et une valeur de correspondance.

CSimpleMap::RemoveAll

Supprime toutes les clés et valeurs.

CSimpleMap::RemoveAt

Supprime une clé et une valeur spécifiques de correspondance.

CSimpleMap::ReverseLookup

Retourne la clé associée à la valeur donnée.

CSimpleMap::SetAt

Définit la valeur associée à la clé spécifiée.

CSimpleMap::SetAtIndex

Définit la clé et la valeur spécifiques.

Notes

CSimpleMap fournit la prise en charge d'un tableau de mappage simple de n'importe quel type donné T, la gestion d'un tableau non ordonné d'éléments clés et leurs valeurs associées.

Le paramètre TEqual offre un moyen de définir une fonction d'égalité de deux éléments de type T. En créant une classe semblable à CSimpleMapEqualHelper, il est possible de modifier le comportement du test d'égalité pour toute tableau donné. Par exemple, lors d'un tableau de pointeurs, il peut être utile de définir l'égalité en fonction de les valeurs des pointeurs de référence. L'implémentation par défaut utilise operator==().

CSimpleMap et CSimpleArray sont fournis pour la compatibilité avec les versions précédentes ATL, les implémentations et plus complètes et plus efficace de collection sont fournies par CAtlArray et CAtlMap.

Contrairement à d'autres collections de cartes de ATL et MFC, cette classe est implémentée avec un tableau simple, et la recherche de correspondance nécessitent une recherche linéaire. CAtlMap doit être utilisé lorsque le tableau contient un grand nombre d'éléments.

Configuration requise

Header: atlsimpcoll.h

Exemple

// Create a map with an integer key and character pointer value
CSimpleMap<int, char *> iArray;   

Voir aussi

Autres ressources

Vue d'ensemble de la classe ATL