CMapStringToString, classe

Prend en charge les mappages d'objets CString indexés par des objets CString .

Syntaxe

class CMapStringToString : public CObject

Membres

Les fonctions membres de CMapStringToString sont similaires aux fonctions membres de la classe CMapStringToOb. Ainsi, vous pouvez utiliser la documentation de référence de CMapStringToOb pour connaître les spécificités des fonctions membres. Où que vous voyiez un CObject pointeur comme une valeur de retour ou un paramètre de fonction « output », remplacez un pointeur par char. Où que vous voyiez un CObject pointeur en tant que paramètre de fonction « entrée », remplacez un pointeur par char.

BOOL CMapStringToString::Lookup(LPCTSTR<key>, CString&<rValue>) const;

par exemple, se traduit par

BOOL CMapStringToOb::Lookup(const char*<key>, CObject*&<rValue>) const;

Structures publiques

Nom	Description
CMapStringToString ::CPair	Structure imbriquée contenant une valeur de clé et la valeur de l’objet chaîne associé.

Constructeurs publics

Nom	Description
CMapStringToString ::CMapStringToString	Constructeur.

Méthodes publiques

Nom	Description
CMapStringToString ::GetCount	Retourne le nombre d’éléments de cette carte.
CMapStringToString ::GetHashTableSize	Détermine le nombre actuel d’éléments dans la table de hachage.
CMapStringToString ::GetNextAssoc	Obtient l’élément suivant pour itérer.
CMapStringToString ::GetSize	Retourne le nombre d’éléments de cette carte.
CMapStringToString ::GetStartPosition	Retourne la position du premier élément.
CMapStringToString ::HashKey	Calcule la valeur de hachage d’une clé spécifiée.
CMapStringToString ::InitHashTable	Initialise la table de hachage.
CMapStringToString ::IsEmpty	Teste la condition de mappage vide (aucun élément).
CMapStringToString ::Lookup	Recherche un pointeur void basé sur la clé de pointeur void. La valeur du pointeur, et non l’entité vers laquelle il pointe, est utilisée pour la comparaison de clés.
CMapStringToString ::LookupKey	Retourne une référence à la clé associée à la valeur de clé spécifiée.
CMapStringToString ::P GetFirstAssoc	Obtient un pointeur vers le premier CString de la carte.
CMapStringToString ::P GetNextAssoc	Obtient un pointeur vers la suivante CString pour itérer.
CMapStringToString ::P Lookup	Retourne un pointeur vers une CString valeur dont la valeur correspond à la valeur spécifiée.
CMapStringToString ::RemoveAll	Supprime tous les éléments de cette carte.
CMapStringToString ::RemoveKey	Supprime un élément spécifié par une clé.
CMapStringToString ::SetAt	Insère un élément dans la carte ; remplace un élément existant si une clé correspondante est trouvée.

Opérateurs publics

Nom	Description
CMapStringToString ::operator [ ]	Insère un élément dans la carte — substitution d’opérateur pour SetAt.

Notes

CMapStringToString incorpore la macro IMPLEMENT_SERIAL pour prendre en charge la sérialisation et le vidage de ses éléments. Chaque élément est sérialisé à son tour si une carte est stockée dans une archive, avec l’opérateur d’insertion surchargée ( <<) ou avec la Serialize fonction membre.

Si vous avez besoin d’un vidage d’éléments individuels CString- CString , vous devez définir la profondeur du contexte de vidage sur 1 ou supérieur.

Lorsqu’un CMapStringToString objet est supprimé ou lorsque ses éléments sont supprimés, les objets sont supprimés selon les CString besoins.

Pour plus d’informations sur CMapStringToString, consultez l’article Collections.

Hiérarchie d'héritage

CObject

CMapStringToString

Spécifications

En-tête : afxcoll.h

CMapStringToString ::CPair

Contient une valeur de clé et la valeur de l’objet chaîne associé.

Notes

Il s’agit d’une structure imbriquée dans la classe CMapStringToString.

La structure se compose de deux champs :

• key Valeur réelle du type de clé.

• value Valeur de l’objet associé.

Il est utilisé pour stocker les valeurs de retour de CMapStringToString ::P Lookup, CMapStringToString ::P GetFirstAssoc et CMapStringToString ::P GetNextAssoc.

Exemple

Pour obtenir un exemple d’utilisation, consultez l’exemple de CMapStringToString ::P Lookup.

CMapStringToString ::P GetFirstAssoc

Retourne la première entrée de l’objet map.

const CPair* PGetFirstAssoc() const;

CPair* PGetFirstAssoc();

Valeur de retour

Pointeur vers la première entrée dans la carte ; voir CMapStringToString ::CPair. Si la carte est vide, la valeur est NULL.

Notes

Appelez cette fonction pour renvoyer un pointeur le premier élément de l’objet map.

Exemple

CMapStringToString myMap;
CString myStr[4] = {_T("One"), _T("Two"), _T("Three"), _T("Four")};
CMapStringToString::CPair *pCurVal;

myMap.InitHashTable(257);

// Add 4 elements to the map.
myMap.SetAt(myStr[0], _T("Odd"));
myMap.SetAt(myStr[1], _T("Even"));
myMap.SetAt(myStr[2], _T("Odd"));
myMap.SetAt(myStr[3], _T("Even"));

pCurVal = myMap.PGetFirstAssoc();
while (pCurVal != NULL)
{
   _tprintf_s(_T("Current key value at %s: %s\n"),
              pCurVal->key, pCurVal->value);
   pCurVal = myMap.PGetNextAssoc(pCurVal);
}

CMapStringToString ::P GetNextAssoc

Récupère l’élément de carte pointé par pAssocRec.

const CPair *PGetNextAssoc(const CPair* pAssoc) const;

CPair *PGetNextAssoc(const CPair* pAssoc);

Paramètres

pAssoc
Pointe vers une entrée de carte retournée par un appel PGetNextAssoc ou PGetFirstAssoc précédent.

Valeur de retour

Pointeur vers l’entrée suivante dans la carte ; voir CMapStringToString ::CPair. Si l’élément est le dernier de la carte, la valeur est NULL.

Notes

Appelez cette méthode pour itérer à travers tous les éléments de la carte. Récupérez le premier élément avec un appel à PGetFirstAssoc , puis effectuez une itération dans la carte avec des appels successifs à PGetNextAssoc.

Exemple

Consultez l’exemple de CMapStringToString ::P GetFirstAssoc.

CMapStringToString ::P Lookup

Recherche la valeur mappée à une clé donnée.

const CPair* PLookup(LPCTSTR key) const;

CPair* PLookup(LPCTSTR key);

Paramètres

key
Pointeur vers la clé de l’élément à rechercher.

Valeur de retour

Pointeur vers la clé spécifiée.

Notes

Appelez cette méthode pour rechercher un élément de carte avec une clé qui correspond exactement à la clé donnée.

Exemple

CMapStringToString myMap;
CString myStr[4] = {_T("One"), _T("Two"), _T("Three"), _T("Four")};

myMap.InitHashTable(257);

// Add 4 elements to the map.
myMap.SetAt(myStr[0], _T("Odd"));
myMap.SetAt(myStr[1], _T("Even"));
myMap.SetAt(myStr[2], _T("Odd"));
myMap.SetAt(myStr[3], _T("Even"));

// Print the element values with odd key values.
CMapStringToString::CPair *pCurVal;

for (int i = 0; i < 4; i += 2)
{
   pCurVal = myMap.PLookup(myStr[i]);
   _tprintf_s(_T("Current key value at %s: %s\n"),
              pCurVal->key, pCurVal->value);
}

Voir aussi

Exemple MFC COLLECT
CObject, classe
Graphique hiérarchique