CMap-Klasse

Eine Wörterbuchauflistungsklasse, die eindeutige Schlüssel auf Werte zuordnet.

template< class KEY, class ARG_KEY, class VALUE, class ARG_VALUE >class CMap : public CObject

Parameter

• KEY
  Klasse des Objekts verwendet als Schlüssel zur Zuordnung.

• ARG*_*KEY
  Datentyp verwendet für KEY-Argumente; normalerweise ein Verweis auf KEY.

• VALUE
  Klasse des Objekts gespeichert in der Zuordnung.

• ARG*_*VALUE
  Datentyp verwendet für VALUE-Argumente; normalerweise ein Verweis auf VALUE.

Mitglieder

Öffentliche Strukturen

Name	Description
CMap::CPair	Eine geschachtelte Struktur, die einen Schlüsselwert und den Wert des zugeordneten Objekts enthält.

Öffentliche Konstruktoren

Name	Description
CMap::CMap	Erstellt eine Auflistung, die Schlüssel zu den Werten zuordnet.

Öffentliche Methoden

Name	Description
CMap::GetCount	Gibt die Anzahl von Elementen in dieser Zuordnung zurück.
CMap::GetHashTableSize	Gibt die Anzahl der Elemente in der Hashtabelle zurück.
CMap::GetNextAssoc	Ruft das folgende Element zum Durchlaufen ab.
CMap::GetSize	Gibt die Anzahl von Elementen in dieser Zuordnung zurück.
CMap::GetStartPosition	Gibt die Position des ersten Elements zurück.
CMap::InitHashTable	Initialisiert die Hashtabelle und gibt seine Größe an.
CMap::IsEmpty	Tests für die EMPTYZuordnung Zustand (keine Elemente).
CMap::Lookup	Dynamic Data sucht nach den Wert, der einer angegebenen Schlüssel zugeordnet ist.
CMap::PGetFirstAssoc	Gibt einen Zeiger auf das erste Element zurück.
CMap::PGetNextAssoc	Ruft einen Zeiger auf das folgende Element zum Durchlaufen.
CMap::PLookup	Gibt einen Zeiger auf eine Schlüssel zurück, deren Wert den angegebenen Wert entspricht.
CMap::RemoveAll	Entfernt alle Elemente aus dieser Zuordnung.
CMap::RemoveKey	Entfernt ein Element, das über einen Schlüssel angegeben wird.
CMap::SetAt	Fügt ein Element in die Zuordnung ein; ersetzt ein vorhandenes Element, wenn ein übereinstimmender Schlüssel gefunden wird.

Öffentliche Operatoren

Name	Description
CMap::operator [ ]	Fügt ein Element in die Zuordnung Operatorersatz für SetAt ein.

Hinweise

Nachdem Sie ein Schlüssel-Wert-Paar (- Element) in die Zuordnung eingefügt haben, können Sie die beiden mithilfe der Schlüssel effizient abrufen oder löschen, um darauf zuzugreifen.Sie können über alle Elemente in der Zuordnung aber auch.

Eine Variable vom Typ POSITION wird für alternativen Zugriff zu Einträgen verwendet.Sie können POSITION verwenden "der Anmeldedaten an einen Eintrag und durch die Zuordnung durchlaufen.Möglicherweise gehen Sie davon aus, dass diese Iteration durch Schlüsselwert sequenziell ist; nicht berücksichtigt.Die Sequenz der abgerufenen Elemente ist unbestimmt.

Bestimmte Memberfunktionen dieser Klasse rufen globale Hilfsfunktionen auf, die für die meisten Verwendungsmöglichkeiten der Klasse CMap angepasst werden müssen.Siehe Auflistungsklassen-Hilfen im Makro- und Werteabschnitt MFCReference.

CMap überschreibt CObject::Serialize, um die Serialisierung und das Speichern seiner Elemente zu unterstützen.Wenn eine Zuordnung zu einem Archiv mithilfe Serialize gespeichert wird, wird jedes Kartenelement wiederum serialisiert.Die Standardimplementierung der SerializeElements Hilfsfunktion führt eine bitweise schreiben.Weitere Informationen zur Serialisierung von den Zeigerauflistungselementen, die von CObject oder anderen benutzerdefinierten Typen abgeleitet werden, finden Sie unter Gewusst wie: Führen Sie eine typsichere Auflistung.

Wenn Sie einen Diagnosen Dump der einzelnen Elemente in der Zuordnung (die Schlüssel und Werte) benötigen, müssen Sie die Tiefe des Dumpkontexts auf 1 festlegen oder größer ist.

Wenn ein CMap-Objekt gelöscht oder wenn seine Elemente entfernt werden, werden die Schlüssel und Werte beide entfernt.

Zuordnungsklassenableitung ist zur Listenableitung ähnlich.Weitere Informationen finden Sie im Artikel Auflistungen für eine Abbildung der Ableitung einer Listenklasse für spezielle Zwecke.

Vererbungshierarchie

CObject

CMap

Anforderungen

Header: afxtempl.h

Siehe auch

Referenz

CObject-Klasse

Hierarchien-Diagramm

Konzepte

MFC-Beispiel COLLECT