CSimpleMap, classe

Article
06/09/2015

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

Partager via