multimap (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 multimap per gestire una sequenza di elementi come (quasi) è bilanciato la struttura ad albero ordinato di nodi, ogni un elemento archiviante.Un elemento è costituito da una chiave, per ordinare la sequenza e di un valore mappato, che passa avanti per disattivare.

Nella descrizione di seguito, GValue sono gli stessi di:

Microsoft::VisualC::StlClr::GenericPair<GKey, GMapped>

Dove:

GKey sono gli stessi di Key a meno che quest'ultimo sia un tipo di riferimento, nel qual caso viene Key^

GMapped sono gli stessi di Mapped a meno che quest'ultimo sia un tipo di riferimento, nel qual caso viene Mapped^

template<typename Key,
    typename Mapped>
    ref class multimap
        :   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::ITree<Gkey, GValue>
    { ..... };

Parametri

Chiave
Tipo del componente chiave di un elemento nella sequenza controllata.
mappato
Il tipo del componente aggiuntivo di un elemento nella sequenza selezionata.

Membri

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

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

Operatore	Descrizione
multimap::operator= (STL/CLR)	Sostituisce la sequenza selezionata.
operator!= (multimap) (STL/CLR)	Determina se un oggetto di multimap non è uguale a un altro oggetto di multimap .
operator< (multimap) (STL/CLR)	Determina se un oggetto di multimap è inferiore a un altro oggetto di multimap .
operator<= (multimap) (STL/CLR)	Determina se un oggetto di multimap è minore o uguale a un altro oggetto di multimap .
operator== (multimap) (STL/CLR)	Determina se un oggetto di multimap equivale a un altro oggetto di multimap .
operator> (multimap) (STL/CLR)	Determina se un oggetto di multimap è maggiore di un altro oggetto di multimap .
operator>= (multimap) (STL/CLR)	Determina se un oggetto di multimap è maggiore o uguale a un altro oggetto di multimap .

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.
ITree<chiave, valore>	gestire il contenitore generico.

Note

L'oggetto alloca e libera la memoria per la sequenza che controlla come singoli nodi.Inserisce gli elementi in un oggetto (quasi) non è bilanciato la struttura ad albero che lo mantiene ordinato modifica dei collegamenti tra i nodi, mai copiando 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 la sequenza che controlla chiamando un oggetto delegato archiviato di tipo multimap::key_compare (STL/CLR).È possibile specificare l'oggetto delegato archiviato quando si crea il multimap, se non si specifica oggetto delegato, l'impostazione predefinita è il confronto operator<(key_type, key_type).È possibile accedere a questo oggetto archiviato chiamando la funzione membro multimap::key_comp (STL/CLR)().

Tale oggetto delegato necessario imporre un ordine debole rigido le chiavi di tipo multimap::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) è true, quindi key_comp()(Y, X) deve essere false.

Se key_comp()(X, Y) è true, quindi X sarebbe ordinato prima di Y.

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

Per qualsiasi elemento X che precede Y nella sequenza selezionata, key_comp()(Y, X) è false.(Per l'oggetto delegato predefinito, chiavi non diminuiscono mai il valore.) A differenza della classe modello map (STL/CLR), un oggetto di classe modello multimap non richiede che le chiavi per tutti gli elementi siano univoche.(Due o più tasti possono avere ordine equivalente.)

ogni elemento contiene una chiave separata e un valore mappato.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 proporzionali al logaritmo del numero di elementi della sequenza (tempo logaritmico).Inoltre, inserendo un elemento non invalida iteratori e la rimozione di un elemento invalida solo gli iteratori che puntano all'elemento rimosso.

Un multimap 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 multimap::end (STL/CLR)().È possibile diminuire questo iteratore per ottenere ultimo elemento nella sequenza selezionata, se presente.È possibile incrementare un iteratore di multimap 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 di multimap direttamente in base alla posizione numerica -- ciò richiede un iteratore di accesso casuale.

Un iteratore di multimap memorizzare l'handle al nodo associato di multimap, 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 multimap rimane valido a condizione che il relativo nodo associato di multimap essere associato a un certo multimap.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.