unordered_multimap::insert
Inserisce un elemento o un intervallo di elementi in un oggetto unordered_multimap.
// (1) single element pair<iterator, bool> insert( const value_type& Val ); // (2) single element, perfect forwarded template<class ValTy> pair<iterator, bool> insert( ValTy&& Val ); // (3) single element with hint iterator insert( const_iterator Where, const value_type& Val ); // (4) single element, perfect forwarded, with hint template<class ValTy> iterator insert( const_iterator Where, ValTy&& Val ); // (5) range template<class InputIterator> void insert( InputIterator First, InputIterator Last ); // (6) initializer list void insert( initializer_list<value_type> IList );
Parametri
Parametro |
Descrizione |
Val |
Valore di un elemento da inserire in unordered_multimap. |
Where |
Posizione in cui iniziare a cercare il punto di inserimento corretto. |
ValTy |
Parametro modello che specifica il tipo di argomenti che può essere usato da unordered_multimap per costruire un elemento di value_type e che esegue l'inoltro perfetto di Val come argomento. |
First |
Posizione del primo elemento da copiare. |
Last |
Posizione immediatamente dopo l'ultimo elemento da copiare. |
InputIterator |
Argomento della funzione di modello che soddisfa i requisiti di un iteratore di input che fa riferimento agli elementi di un tipo che possono essere usati per costruire oggetti value_type. |
IList |
Oggetto initializer_list da cui copiare gli elementi. |
Valore restituito
Le funzioni membro di inserimento a elemento singolo, (1) e (2), restituiscono un iteratore alla posizione in cui il nuovo elemento è stato inserito in unordered_multimap.
Le funzioni membro a elemento singolo con suggerimento, (3) e (4), restituiscono un iteratore che fa riferimento alla posizione in cui il nuovo elemento è stato inserito in unordered_multimap.
Note
Questa funzione non invalida alcun puntatore o riferimento, ma potrebbe invalidare tutti gli iteratori per il contenitore.
Se viene generata un'eccezione durante l'inserimento di un solo elemento, ma l'eccezione non si manifesta nella funzione hash del contenitore, lo stato del contenitore non verrà modificato. Se l'eccezione viene generata nella funzione hash, il risultato non sarà definito. Se viene generata un'eccezione durante l'inserimento di più elementi, il contenitore viene lasciato in uno stato non specificato ma comunque valido.
Il value_type di un contenitore è un typedef appartenente al contenitore e per la mappa map<K, V>::value_type è pair<const K, V>. Il valore di un elemento è una coppia ordinata in cui il primo componente equivale al valore della chiave e il secondo componente equivale al valore dati dell'elemento.
La funzione membro di intervallo (5) inserisce la sequenza di valori di elemento in un unordered_multimap che corrisponde a ogni elemento interessato da un iteratore nell'intervallo [First, Last). Non viene quindi inserito Last. La funzione membro di contenitore end() fa riferimento alla posizione immediatamente dopo l'ultimo elemento nel contenitore. L'istruzione m.insert(v.begin(), v.end());, ad esempio, cerca di inserire tutti gli elementi di v in m.
La funzione membro di elenco dell'inizializzatore (6) usa un initializer_list per copiare gli elementi in unordered_multimap.
Per l'inserimento di un elemento creato sul posto, ovvero senza esecuzione di operazioni di copia o spostamento, vedere unordered_multimap::emplace e unordered_multimap::emplace_hint.
Per un esempio di codice, vedere multiset::insert.
Requisiti
Intestazione: <unordered_map>
Spazio dei nomi: std