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
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 :
keyValeur réelle du type de clé.valueValeur 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);
}