Classe di CMap

Una classe di raccolta dizionario che esegue il mapping delle chiavi univoche ai valori.

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

Parametri

• KEY
  Classe dell'oggetto utilizzato come chiave al mapping.

• ARG*_*KEY
  Tipo di dati utilizzato per gli argomenti KEY ; generalmente un riferimento a KEY.

• VALUE
  Classe dell'oggetto archiviato nella mappa.

• ARG*_*VALUE
  Tipo di dati utilizzato per gli argomenti VALUE ; generalmente un riferimento a VALUE.

Membri

Strutture pubbliche

Nome	Descrizione
CMap::CPair	Una struttura annidata che contiene un valore di chiave e il valore dell'oggetto collegato.

Costruttori pubblici

Nome	Descrizione
CMap::CMap	Crea una raccolta mappata chiavi ai valori.

Metodi pubblici

Nome	Descrizione
CMap::GetCount	Restituisce il numero di elementi in questa mappa.
CMap::GetHashTableSize	Restituisce il numero di elementi nella tabella hash.
CMap::GetNextAssoc	Ottiene l'elemento seguente per l'iterazione.
CMap::GetSize	Restituisce il numero di elementi in questa mappa.
CMap::GetStartPosition	Restituisce la posizione del primo elemento.
CMap::InitHashTable	Inizializza un hash presenti e specifica la dimensione.
CMap::IsEmpty	Test per lo stato del Vuoto- mapping (alcun elemento).
CMap::Lookup	Trova il valore mappato alla chiave specificata.
CMap::PGetFirstAssoc	Restituisce un puntatore al primo elemento.
CMap::PGetNextAssoc	Ottiene un puntatore all'elemento successivo per l'iterazione.
CMap::PLookup	Restituisce un puntatore a una chiave del cui valore corrisponde al valore specificato.
CMap::RemoveAll	Rimuove tutti gli elementi da questa mappa.
CMap::RemoveKey	Rimuove un elemento specificato da una chiave.
CMap::SetAt	Inserisce un elemento nella mappa, sostituire un elemento esistente se una chiave corrispondente viene trovata.

Operatori pubblici

Nome	Descrizione
CMap::operator [ ]	Inserisce un elemento nel mapping alla sostituzione dell'operatore per SetAt.

Note

Una volta aggiunto una coppia chiave-valore (elemento) nel mapping, è possibile recuperare o eliminare in modo efficiente la coppia utilizzando la chiave per accedervi.È inoltre possibile scorrere tutti gli elementi nella mappa.

Una variabile di tipo POSITION viene utilizzata per l'accesso di alternativa alle voci.È possibile utilizzare POSITION "" si ricorda una voce e scorrere il mapping.Si potrebbe pensare che l'iterazione è sequenziale per valore della chiave; non è.La sequenza di elementi recuperati è indeterminata.

Alcune funzioni membro della classe chiamano funzioni di supporto globali che devono essere personalizzate per la maggior parte di utilizzare la classe CMap.Vedere Supporto della classe di raccolta nella sezione Globals e macro MFCReference.

CMap esegue l'override CObject::Serialize per supportare la serializzazione e il dump degli elementi.Se un mapping viene archiviato in un archivio utilizzando Serialize, ogni elemento mapping viene serializzato a sua volta.L'implementazione predefinita della funzione di supporto SerializeElements esegue un'operazione bit per bit scrittura.Per informazioni sulla serializzazione degli elementi della raccolta del puntatore derivati da CObject o altri tipi definiti dall'utente, vedere Procedura: Fare una raccolta indipendente dai tipi.

Se è necessario un dump di diagnostica dei singoli elementi nel mapping (chiavi e valori), è necessario impostare la profondità del contesto di dump a 1 o superiore.

Quando un oggetto CMap viene eliminato, oppure quando gli elementi vengono rimossi, le chiavi e i valori di entrambe vengono rimossi.

La derivazione della classe di mapping è simile alla derivazione dell'elenco.Vedere l'articolo Raccolte per un'illustrazione di derivazione di una classe per scopi specifici dell'elenco.

Gerarchia di ereditarietà

CObject

CMap

Requisiti

Header: afxtempl.h

Vedere anche

Riferimenti

Classe di CObject

Grafico della gerarchia

Concetti

L'esempio MFC SI RACCOGLIE