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
.gif "s897094z.collapse_all(de-de,VS.110).gif")
Öffentliche Strukturen
Name |
Description |
|---|---|
Eine geschachtelte Struktur, die einen Schlüsselwert und den Wert des zugeordneten Objekts enthält. |
Öffentliche Konstruktoren
Name |
Description |
|---|---|
Erstellt eine Auflistung, die Schlüssel zu den Werten zuordnet. |
Öffentliche Methoden
Name |
Description |
|---|---|
Gibt die Anzahl von Elementen in dieser Zuordnung zurück. |
|
Gibt die Anzahl der Elemente in der Hashtabelle zurück. |
|
Ruft das folgende Element zum Durchlaufen ab. |
|
Gibt die Anzahl von Elementen in dieser Zuordnung zurück. |
|
Gibt die Position des ersten Elements zurück. |
|
Initialisiert die Hashtabelle und gibt seine Größe an. |
|
Tests für die EMPTYZuordnung Zustand (keine Elemente). |
|
Dynamic Data sucht nach den Wert, der einer angegebenen Schlüssel zugeordnet ist. |
|
Gibt einen Zeiger auf das erste Element zurück. |
|
Ruft einen Zeiger auf das folgende Element zum Durchlaufen. |
|
Gibt einen Zeiger auf eine Schlüssel zurück, deren Wert den angegebenen Wert entspricht. |
|
Entfernt alle Elemente aus dieser Zuordnung. |
|
Entfernt ein Element, das über einen Schlüssel angegeben wird. |
|
Fügt ein Element in die Zuordnung ein; ersetzt ein vorhandenes Element, wenn ein übereinstimmender Schlüssel gefunden wird. |
Öffentliche Operatoren
Name |
Description |
|---|---|
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
CMap
Anforderungen
Header: afxtempl.h