Classe CMapStringToOb

Articolo
06/10/2015

Una classe di raccolta dizionario che esegue il mapping CString univoco oggetti a puntatori CObject.

class CMapStringToOb : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CMapStringToOb::CMapStringToOb	Costruttore.

Metodi pubblici

Nome	Descrizione
CMapStringToOb::GetCount	Restituisce il numero di elementi in questa mappa.
CMapStringToOb::GetHashTableSize	Determina il numero corrente degli elementi nella tabella hash.
CMapStringToOb::GetNextAssoc	Ottiene l'elemento seguente per l'iterazione.
CMapStringToOb::GetSize	Restituisce il numero di elementi in questa mappa.
CMapStringToOb::GetStartPosition	Restituisce la posizione del primo elemento.
CMapStringToOb::HashKey	Calcola il valore hash della chiave specificata.
CMapStringToOb::InitHashTable	Inizializza la tabella hash.
CMapStringToOb::IsEmpty	Test per lo stato del Vuoto- mapping (alcun elemento).
CMapStringToOb::Lookup	Cerca un puntatore a void base alla chiave del puntatore a void. Il valore del puntatore, non l'entità che indica, viene utilizzato per il confronto principale.
CMapStringToOb::LookupKey	Restituisce un riferimento alla chiave associata al valore della chiave specificato.
CMapStringToOb::RemoveAll	Rimuove tutti gli elementi da questa mappa.
CMapStringToOb::RemoveKey	Rimuove un elemento specificato da una chiave.
CMapStringToOb::SetAt	Inserisce un elemento nella mappa, sostituire un elemento esistente se una chiave corrispondente viene trovata.

Operatori pubblici

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

Note

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

Una variabile di tipo POSITION viene utilizzata per accesso alternativo voce in tutte le variazioni di mapping. È 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.

CMapStringToOb include la macro IMPLEMENT_SERIAL per supportare la serializzazione e il dump degli elementi. Ogni elemento viene serializzato a sua volta se un mapping viene archiviato in un archivio, con l'operatore di overload di inserimento (<<) o con la funzione membro Serialize.

Se è necessario un dump di diagnostica dei singoli elementi nel mapping (il valore CString e contenuto CObject ), è necessario impostare la profondità del contesto di dump a 1 o superiore.

Quando un oggetto CMapStringToOb viene eliminato, oppure quando gli elementi vengono rimossi, gli oggetti CString e i puntatori CObject vengono rimossi. Gli oggetti a cui fanno riferimento i puntatori CObject non vengono eliminati.

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.