CSimpleMap-Klasse

Artikel
02/26/2013

Diese Klasse stellt Unterstützung für ein einfaches Zuordnungsarray.

template < 
   class TKey,
   class TVal,
   class TEqual = CSimpleMapEqualHelper< TKey, TVal > 
> 
class CSimpleMap

Parameter

TKey
Der Schlüsselelementtyp.
TVal
Der Wertselementtyp.
TEqual
Ein Merkmalsobjekt, den Übereinstimmungstest für Elemente des Typs T definiert.

Mitglieder

Öffentliche Typedefs

Name	Description
CSimpleMap::_ArrayElementType	Typedef für den Werttyp.
CSimpleMap::_ArrayKeyType	Typedef für den Schlüsseltyp.

Öffentliche Konstruktoren

Name	Description
CSimpleMap::CSimpleMap	Der -Konstruktor.
CSimpleMap::~CSimpleMap	Der Destruktor.

Öffentliche Methoden

Name	Description
CSimpleMap::Add	Fügt einen Schlüssel und einen zugeordneten Wert dem Zuordnungsarray hinzu.
CSimpleMap::FindKey	Wenn eine bestimmte Schlüssel.
CSimpleMap::FindVal	Sucht einen bestimmten Wert.
CSimpleMap::GetKeyAt	Ruft den angegebenen Schlüssel ab.
CSimpleMap::GetSize	Gibt die Anzahl der Einträge im Zuordnungsarray zurück.
CSimpleMap::GetValueAt	Ruft den angegebenen Wert ab.
CSimpleMap::Lookup	Gibt den Wert zurück, der dem angegebenen Schlüssel zugeordnet ist.
CSimpleMap::Remove	Entfernt einen Schlüssel und einen entsprechenden Wert.
CSimpleMap::RemoveAll	Entfernt alle Schlüssel und Werte.
CSimpleMap::RemoveAt	Entfernt einen bestimmten Schlüssel und einen entsprechenden Wert.
CSimpleMap::ReverseLookup	Gibt den Schlüssel zurück, die dem angegebenen Wert zugeordnet ist.
CSimpleMap::SetAt	Legt den Wert fest, der dem angegebenen Schlüssel zugeordnet ist.
CSimpleMap::SetAtIndex	Legt die bestimmte Schlüssel und Wert fest.

Hinweise

CSimpleMap bietet Unterstützung für ein einfaches Zuordnungsarray eines angegebenen Typs T und verwaltet ein Array ungeordnetes Schlüsselelemente und ihre zugeordneten Werte.

Der Parameter TEqual stellt Mittel zum Definieren einer Gleichheitsfunktion für zwei Elemente des Typs T bereit.Durch Erstellen einer Klasse, die zu CSimpleMapEqualHelper vergleichbar ist, ist es möglich, das Verhalten des Gleichheitstests für jedes angegebene Array zu ändern.Beispielsweise bei der Behandlung von ein Array von Zeigern, es möglicherweise nützlich ist, Gleichheits- wie je nach den Werten zu definieren, die Zeiger verweisen.Die Standardimplementierung verwendet operator==().

werden CSimpleMap und CSimpleArray für die Kompatibilität mit früheren ATL-Versionen bereitgestellt, und vollständigere und effizientere Auflistungsimplementierungen werden von CAtlArray und von CAtlMap bereitgestellt.

Im Gegensatz zu anderen Zuordnungsauflistungen in ATL und in MFC, wird diese Klasse mit einem einfachen Array implementiert, und Suchensuchen erfordern eine lineare Suche.CAtlMap sollte verwendet werden, wenn das Array viele Elemente enthält.

Anforderungen

Header: atlsimpcoll.h

Beispiel

// Create a map with an integer key and character pointer value
CSimpleMap<int, char *> iArray;

Siehe auch

Weitere Ressourcen

ATL-Klassenübersicht

Freigeben über