Classe di CMapStringToOb

Articolo
03/26/2013

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.