Udostępnij za pośrednictwem

Klasa CMap

  • Artykuł

Klasa kolekcji słownika, który mapuje wartości unikatowe klucze.

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

Parametry

  • KEY
    Klasa obiektu używanego jako klucz do mapy.

  • ARG _ KEY
    Typ danych używany dla KEY argumentów; Zazwyczaj odniesienie do KEY.

  • VALUE
    Klasa obiektów przechowywanych w mapie.

  • ARG _ VALUE
    Typ danych używany dla VALUE argumentów; Zazwyczaj odniesienie do VALUE.

Członkowie

Struktur publicznych

Nazwa

Opis

CMap::CPair

Struktury zagnieżdżone zawierające wartość klucza i wartość obiektu skojarzonego.

Publiczne konstruktory

Nazwa

Opis

CMap::CMap

Konstrukcje kolekcji, który mapuje wartości kluczy.

Metody publiczne

Nazwa

Opis

CMap::GetCount

Zwraca liczbę elementów w tej mapy.

CMap::GetHashTableSize

Zwraca liczbę elementów w tabeli mieszania.

CMap::GetNextAssoc

Iterowanie pobiera następnego elementu.

CMap::GetSize

Zwraca liczbę elementów w tej mapy.

CMap::GetStartPosition

Zwraca pozycję pierwszego elementu.

CMap::InitHashTable

Inicjuje tabeli mieszania i określa jego rozmiar.

CMap::IsEmpty

Testy dla warunku mapę puste (Brak elementów).

CMap::Lookup

Wyszukuje wartość mapowane do danego klucza.

CMap::PGetFirstAssoc

Zwraca wskaźnik do pierwszego elementu.

CMap::PGetNextAssoc

Pobiera wskaźnik do następnego elementu dla iteracji.

CMap::PLookup

Zwraca wskaźnik do klucza, którego wartość odpowiada określonej wartości.

CMap::RemoveAll

Usuwa wszystkie elementy z tej mapy.

CMap::RemoveKey

Usuwa element określony przez klucz.

CMap::SetAt

Wstawia element do mapy; zastępuje istniejącego elementu, jeśli zostanie znaleziony pasujący klucza.

Podmioty publiczne

Nazwa

Opis

[CMap::operator]

Wstawia element do mapy — zastąpienia operator SetAt.

Uwagi

Po wstawieniu parę klucz wartość (element) do mapy można skutecznie pobrać lub usunąć parę do niego dostęp przy użyciu klucza.Można również iteracyjne wszystkie elementy na mapie.

Zmienna typu stanowisko jest używana do alternatywnego dostępu do wpisów.Można użyć stanowisko "remember" wpis i iterację mapy.Myślisz jest iteracją sekwencyjnych przez wartość klucza; nie jest.Sekwencja pobranych elementów jest nieokreślony.

Niektórych funkcji elementów członkowskich tego wywołania klasa helper globalnego funkcji, które muszą być dostosowane dla większości zastosowań CMap klasy.Zobacz Pomocnicy klasy kolekcji w sekcji makr i Globals MFCReference.

CMapzastępuje CObject::Serialize do serializacji i dumpingu z jego elementów.Jeśli mapa jest przechowywany do archiwum za pomocą Serialize, każdy element mapy jest z kolei seryjny.Domyślne wykonania SerializeElements robi funkcja helper bitowe zapisu.Dla informacji o serializacji wskaźnik kolekcji elementów pochodzących z CObject lub inne typy zdefiniowane przez użytkownika, zobacz Porady: tworzenie bezpiecznej kolekcji.

Diagnostyczne zrzutu pojedynczych elementów w tablicy (klucze i wartości), należy należy ustawić głębokość kontekstu zrzutu 1 lub większą.

Gdy CMap usunąć obiektu lub po jego elementy są usuwane, klucze i wartości są usuwane.

Wyprowadzenie klasy mapy jest podobna do listy wyprowadzenie.Zobacz artykuł kolekcji ilustrację wyprowadzenie klasy listy specjalnych.

Hierarchii dziedziczenia

CObject

CMap

Wymagania

Nagłówek: afxtempl.h

Zobacz też

Informacje

Klasa CObject

Diagram hierarchii

Koncepcje

Próbki MFC ZEBRAĆ