Freigeben über


CSimpleMap Class

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 Class Overview