Classe 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 |
---|---|
Una struttura annidata che contiene un valore di chiave e il valore dell'oggetto collegato. |
Costruttori pubblici
Nome |
Descrizione |
---|---|
Crea una raccolta mappata chiavi ai valori. |
Metodi pubblici
Nome |
Descrizione |
---|---|
Restituisce il numero di elementi in questa mappa. |
|
Restituisce il numero di elementi nella tabella hash. |
|
Ottiene l'elemento seguente per l'iterazione. |
|
Restituisce il numero di elementi in questa mappa. |
|
Restituisce la posizione del primo elemento. |
|
Inizializza un hash presenti e specifica la dimensione. |
|
Test per lo stato del Vuoto- mapping (alcun elemento). |
|
Trova il valore mappato alla chiave specificata. |
|
Restituisce un puntatore al primo elemento. |
|
Ottiene un puntatore all'elemento successivo per l'iterazione. |
|
Restituisce un puntatore a una chiave del cui valore corrisponde al valore specificato. |
|
Rimuove tutti gli elementi da questa mappa. |
|
Rimuove un elemento specificato da una chiave. |
|
Inserisce un elemento nella mappa, sostituire un elemento esistente se una chiave corrispondente viene trovata. |
Operatori pubblici
Nome |
Descrizione |
---|---|
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: creazione di 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à
CMap
Requisiti
Header: afxtempl.h