CMapStringToOb, classe

Article
06/10/2015

Une classe de collection de dictionnaires qui mappe unique CString des objets aux pointeurs d' CObject .

class CMapStringToOb : public CObject

Membres

Constructeurs publics

Nom	Description
CMapStringToOb::CMapStringToOb	Constructeur.

Méthodes publiques

Nom	Description
CMapStringToOb::GetCount	Retourne le nombre d'éléments dans ce mappage.
CMapStringToOb::GetHashTableSize	Détermine le nombre actuel d'éléments dans la table de hachage.
CMapStringToOb::GetNextAssoc	Obtient l'élément pour itérer.
CMapStringToOb::GetSize	Retourne le nombre d'éléments dans ce mappage.
CMapStringToOb::GetStartPosition	Retourne la position du premier élément.
CMapStringToOb::HashKey	Calcule la valeur de hachage d'une clé spécifiée.
CMapStringToOb::InitHashTable	Initialise la table de hachage.
CMapStringToOb::IsEmpty	Tests de l'état de vide- aucun mappage (éléments).
CMapStringToOb::Lookup	Recherche un pointeur void sur la clé de pointeur void. La valeur de pointeur, pas l'entité qu'elle indique, est utilisée pour la comparaison principale.
CMapStringToOb::LookupKey	Retourne une référence à la clé associée à la valeur de clé spécifiée.
CMapStringToOb::RemoveAll	Supprime tous les éléments de ce mappage.
CMapStringToOb::RemoveKey	Supprime un élément spécifié par une clé.
CMapStringToOb::SetAt	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
CMapStringToOb::operator []	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 d' CString- d'CObject* (élément) dans le mappage, vous pouvez récupérer ou supprimer efficacement les paires à l'aide d'une chaîne ou une valeur d' CString comme clé. 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 d'entrée dans toutes les variations de mappage. 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.

CMapStringToOb incorpore la macro d' IMPLEMENT_SERIAL pour prendre en charge la sérialisation et faire un dump de ses éléments. Chaque élément est sérialisé ensuite si une carte est stockée à une archive, avec ()**<<**l'opérateur surchargé d'insertion ou avec la fonction membre d' Serialize .

Si vous avez besoin d'un dump de diagnostic des éléments individuels dans le mappage (la valeur d' CString et le contenu d' CObject ), vous devez définir la profondeur du contexte de dump à 1 ou supérieur.

Lorsqu'un objet d' CMapStringToOb est supprimé, ou lorsque ses éléments sont supprimés, les objets d' CString et les pointeurs d' CObject sont supprimés. Les objets référencés par des pointeurs d' CObject ne sont pas détruits.

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.