hash_multiset (STL/CLR)

Articolo
06/07/2013

La classe modello vengono descritti un oggetto e controlli di una sequenza variare lunghezza di elementi che ha accesso bidirezionale.Si utilizza il contenitore hash_multiset per gestire una sequenza di elementi come tabella hash, ogni voce della tabella archiviante un elenco collegato bidirezionale di nodi e ogni nodo archiviante un elemento.Il valore di ogni elemento viene utilizzato come chiave, per ordinare la sequenza.

Nella descrizione di seguito, GValue sono gli stessi di GKey, che a sua volta è lo stesso di Key a meno che quest'ultimo sia un tipo di riferimento, nel qual caso viene Key^.

template<typename Key>
    ref class hash_multiset
        :   public
        System::ICloneable,
        System::Collections::IEnumerable,
        System::Collections::ICollection,
        System::Collections::Generic::IEnumerable<GValue>,
        System::Collections::Generic::ICollection<GValue>,
        System::Collections::Generic::IList<GValue>,
        Microsoft::VisualC::StlClr::IHash<Gkey, GValue>
    { ..... };

Parametri

Chiave
Tipo del componente chiave di un elemento nella sequenza controllata.

Membri

Definizione del tipo	Descrizione
hash_multiset::const_iterator (STL/CLR)	Il tipo di iteratore costante per la sequenza selezionata.
hash_multiset::const_reference (STL/CLR)	Il tipo di riferimento costante a un elemento.
hash_multiset::const_reverse_iterator (STL/CLR)	Il tipo di iteratore inverso costante per la sequenza selezionata.
hash_multiset::difference_type (STL/CLR)	Il tipo di distanza (possibilmente con segno) tra due elementi.
hash_multiset::generic_container (STL/CLR)	Il tipo dell'interfaccia generica per il contenitore.
hash_multiset::generic_iterator (STL/CLR)	il tipo di iteratore per l'interfaccia generica per il contenitore.
hash_multiset::generic_reverse_iterator (STL/CLR)	il tipo di iteratore inverso per l'interfaccia generica per il contenitore.
hash_multiset::generic_value (STL/CLR)	il tipo di elemento per l'interfaccia generica per il contenitore.
hash_multiset::hasher (STL/CLR)	Il delegato di hashing di una chiave.
hash_multiset::iterator (STL/CLR)	Il tipo di iteratore per la sequenza selezionata.
hash_multiset::key_compare (STL/CLR)	Il delegato dell'ordine per due chiavi.
hash_multiset::key_type (STL/CLR)	Il tipo di chiave di ordinamento.
hash_multiset::reference (STL/CLR)	Il tipo di riferimento a un elemento.
hash_multiset::reverse_iterator (STL/CLR)	Il tipo di iteratore inverso per la sequenza selezionata.
hash_multiset::size_type (STL/CLR)	Il tipo di distanza (non negativa) di un oggetto tra due elementi.
hash_multiset::value_compare (STL/CLR)	Il delegato dell'ordine per due valori dell'elemento.
hash_multiset::value_type (STL/CLR)	Il tipo di elemento.

Funzione membro	Descrizione
hash_multiset::begin (STL/CLR)	Definisce l'inizio della sequenza controllata.
hash_multiset::bucket_count (STL/CLR)	Calcola il numero dei bucket.
hash_multiset::clear (STL/CLR)	Rimuove tutti gli elementi.
hash_multiset::count (STL/CLR)	Conta gli elementi che soddisfano una chiave specificata.
hash_multiset::empty (STL/CLR)	Verifica se non sono presenti elementi presenti.
hash_multiset::end (STL/CLR)	Definisce la fine della sequenza controllata.
hash_multiset::equal_range (STL/CLR)	I trova variano che corrisponde a una chiave specificata.
hash_multiset::erase (STL/CLR)	Rimuove gli elementi alle posizioni specificate.
hash_multiset::find (STL/CLR)	Viene trovato un elemento che corrisponde alla chiave specificata.
hash_multiset::hash_delegate (STL/CLR)	Copia il delegato di hashing di una chiave.
hash_multiset::hash_multiset (STL/CLR)	Costruisce un oggetto contenitore.
hash_multiset::insert (STL/CLR)	Aggiunge gli elementi.
hash_multiset::key_comp (STL/CLR)	Copia il delegato dell'ordine per due chiavi.
hash_multiset::load_factor (STL/CLR)	Conta gli elementi e l'altro per bucket.
hash_multiset::lower_bound (STL/CLR)	Rileva l'inizio dell'intervallo che corrisponde a una chiave specificata.
hash_multiset::make_value (STL/CLR)	Costruisce un oggetto di valore.
hash_multiset::max_load_factor (STL/CLR)	Ottiene o imposta elementi massimo per bucket.
hash_multiset::rbegin (STL/CLR)	Definisce l'inizio della sequenza inversa controllata.
hash_multiset::rehash (STL/CLR)	Ricompila la tabella hash.
hash_multiset::rend (STL/CLR)	Definisce la fine della sequenza inversa controllata.
hash_multiset::size (STL/CLR)	Conta il numero di elementi.
hash_multiset::swap (STL/CLR)	Scambia il contenuto di due contenitori.
hash_multiset::to_array (STL/CLR)	Copia la sequenza selezionata in una nuova matrice.
hash_multiset::upper_bound (STL/CLR)	Fine di individuare di temporizzazione che corrisponde a una chiave specificata.
hash_multiset::value_comp (STL/CLR)	Copia il delegato dell'ordine per due valori dell'elemento.

Operatore	Descrizione
hash_multiset::operator= (STL/CLR)	Sostituisce la sequenza selezionata.

Interfacce

Interfaccia	Descrizione
ICloneable	Clonare un oggetto.
IEnumerable	Sequenza degli elementi.
ICollection	gestire il gruppo di elementi.
IEnumerable<T>	Sequenza degli elementi tipizzati.
ICollection<T>	gestire il gruppo di elementi tipizzati.
IHash<chiave, valore>	gestire il contenitore generico.

Note

L'oggetto alloca e libera la memoria per la sequenza che controlla come singoli nodi in un elenco collegato bidirezionale.Per velocizzare l'accesso, l'oggetto gestisce inoltre di una matrice di lunghezza dei puntatori nell'elenco (la tabella hash), efficacemente mantenimento dell'elenco di tutto come sequenza di sottoelenchi, o i bucket.Non inserire mai gli elementi in un bucket che mantiene ordinato modifica dei collegamenti tra i nodi, copia il contenuto di un nodo a un altro.Ciò significa che è possibile inserire liberamente e rimuovere elementi senza alterare gli elementi rimanenti.

l'oggetto ordina ogni bucket che controlla chiamando un oggetto delegato archiviato di tipo hash_set::key_compare (STL/CLR).È possibile specificare l'oggetto delegato archiviato quando si crea il hash_set; se non si specifica oggetto delegato, l'impostazione predefinita è il confronto operator<=(key_type, key_type).

Si accede a questo viene archiviato chiamando la funzione membro hash_set::key_comp (STL/CLR)().Tale oggetto delegato deve definire l'ordine equivalente tra le chiavi di tipo hash_set::key_type (STL/CLR).Ciò significa, per due chiavi X e Y:

key_comp()(X, Y) restituisce lo stesso risultato booleano a ogni chiamata.

Se key_comp()(X, Y) && key_comp()(Y, X) è true, quindi X e Y causate da avere ordine equivalente.

Una regola di ordinamento che si comporta come operator<=(key_type, key_type), operator>=(key_type, key_type) o operator==(key_type, key_type) definisce l'ordine eqivalent.

Si noti che il contenitore fornisce solo agli elementi le cui chiavi di ordinamento equivalente e che hash sullo stesso valore Integer) siano adiacenti all'interno di un bucket.A differenza della classe modello hash_set (STL/CLR), un oggetto di classe modello hash_multiset non richiede che le chiavi per tutti gli elementi siano univoche.(Due o più tasti possono avere ordine equivalente.)

L'oggetto determina quale bucket deve contenere una chiave specificata di ordine chiamando un oggetto delegato archiviato di tipo hash_set::hasher (STL/CLR).È possibile accedere a questo oggetto archiviato chiamando la funzione membro hash_set::hash_delegate (STL/CLR)() per ottenere un valore intero che dipende dal valore della chiave.È possibile specificare l'oggetto delegato archiviato quando si crea il hash_set; se non si specifica oggetto delegato, l'impostazione predefinita è la funzione System::Object::hash_value(key_type).Ciò significa, per qualsiasi chiave X e Y:

hash_delegate()(X) restituisce lo stesso risultato intero a ogni chiamata.

Se X e Y ha ordine equivalente, quindi hash_delegate()(X) deve restituire lo stesso risultato completo di hash_delegate()(Y).

Ogni elemento viene utilizzato sia chiave che valore.La sequenza viene rappresentata in una modalità che consente la ricerca, l'inserimento e la rimozione di un elemento arbitrario attraverso una serie di operazioni che è indipendente dal numero di elementi della sequenza (tempo costante) -- almeno nel migliore dei casi.Inoltre, inserendo un elemento non invalida iteratori e la rimozione di un elemento invalida solo gli iteratori che puntano all'elemento rimosso.

Se i valori con hash non vengono distribuiti uniformemente, tuttavia, un hash la tabella può degenerare.Il limite -- per una funzione hash che restituisce sempre lo stesso valore -- la ricerca, l'inserimento e la rimozione sono proporzionali al numero di elementi della sequenza (tempo lineare).Il contenitore tenta di scegliere una funzione hash ragionevole, una dimensione media del bucket e la dimensione della tabella hash (numero totale dei bucket), ma è possibile eseguire l'override di qualsiasi di queste scelte.Vedere, ad esempio, le funzioni hash_set::max_load_factor (STL/CLR) e hash_set::rehash (STL/CLR).

Un hash_multiset supporta gli iteratori bidirezionali, è possibile avanzare agli elementi adiacenti fornito un iteratore che definisce un elemento nella sequenza selezionata.Un nodo head speciale corrisponde all'iteratore restituito da hash_multiset::end (STL/CLR)().È possibile diminuire questo iteratore per ottenere ultimo elemento nella sequenza selezionata, se presente.È possibile incrementare un iteratore di hash_multiset per ottenere il nodo head quindi confronta uguale a end().Ma non è possibile dereferenziare l'iteratore restituito da end().

Si noti che non è possibile fare riferimento a un elemento del hash_multiset direttamente in base alla posizione numerica -- ciò richiede un iteratore di accesso casuale.

Un iteratore di hash_multiset memorizzare l'handle al nodo associato al hash_multiset, che a sua volta memorizzare l'handle al relativo contenitore associato.È possibile utilizzare gli iteratori solo con i relativi oggetti contenitore associati.Un iteratore di hash_multiset rimane valido a condizione che il relativo nodo associato al hash_multiset essere associato a un certo hash_multiset.inoltre, un iteratore valido è dereferencable -- è possibile utilizzarlo per accedere e modificare il valore dell'elemento che definisce -- a condizione che non sia uguale a end().

Cancellando o la rimozione di un elemento chiama il distruttore per il valore archiviato.Eliminare il contenitore di cancellare tutti gli elementi.Pertanto, un contenitore del tipo di elemento è una classe di riferimento garantisce che nessun elemento terminazione il contenitore.Si noti, tuttavia, che un contenitore di handle fa not elimina i relativi elementi.