unordered_multimap::insert
aggiunge gli elementi.
iterator insert(const value_type& val);
iterator insert(iterator where, const value_type& val);
template<class InIt>
void insert(InIt first, InIt last);
template<class ValTy>
iterator insert(ValTy&& val);
template<class ValTy>
iterator insert(const_iterator where, ValTy&& val);
Parametri
Parametro |
Descrizione |
InIt |
il tipo di iteratore. |
ValTy |
Il tipo sul posto dell'argomento del costruttore. |
First |
A partire dall'intervallo da inserire. |
Last |
estremità di intervallo da inserire. |
Val |
valore da inserire. |
Where |
La posizione del contenitore inserire (suggerimento solo). |
Note
la prima funzione membro inserisce l'elemento val nella sequenza selezionata, quindi restituisce l'iteratore che definisce l'elemento inserito.I secondi termine della funzione membro insert(val)tramite, where come posizione iniziale all'interno della sequenza controllata da individuare il punto di inserimento.(Inserimento può anche verificarsi leggermente più veloce, se il punto di inserimento immediatamente precedente a o segue where).
La terza funzione membro inserire la sequenza di valori degli elementi, per ognuno where nell'intervallo [first, last), chiamando insert(*where).
Le ultime due funzioni membro si comportano allo stesso modo dei primi due, eccetto val viene utilizzato per costruire il valore immesso.
Se viene generata un'eccezione durante l'inserimento di un singolo elemento, il contenitore resta invariato e l'eccezione viene generata di nuovo.Se viene generata un'eccezione durante l'inserimento di più elementi, il contenitore viene lasciato in uno stabile ma lo stato non specificato e l'eccezione viene generata di nuovo.
Esempio
// std_tr1__unordered_map__unordered_multimap_insert.cpp
// compile with: /EHsc
#include <unordered_map>
#include <iostream>
#include <string>
typedef std::unordered_multimap<char, int> Mymap;
int main()
{
Mymap c1;
c1.insert(Mymap::value_type('a', 1));
c1.insert(Mymap::value_type('b', 2));
c1.insert(Mymap::value_type('c', 3));
// display contents " [c 3] [b 2] [a 1]"
for (Mymap::const_iterator it = c1.begin();
it != c1.end(); ++it)
std::cout << " [" << it->first << ", " << it->second << "]";
std::cout << std::endl;
// insert with hint and reinspect
Mymap::iterator it2 = c1.insert(c1.begin(), Mymap::value_type('d', 4));
for (Mymap::const_iterator it = c1.begin();
it != c1.end(); ++it)
std::cout << " [" << it->first << ", " << it->second << "]";
std::cout << std::endl;
// insert range and inspect
Mymap c2;
c2.insert(c1.begin(), c1.end());
for (Mymap::const_iterator it = c2.begin();
it != c2.end(); ++it)
std::cout << " [" << it->first << ", " << it->second << "]";
std::cout << std::endl;
// insert new and duplicate, and reinspect
c1.insert(Mymap::value_type('e', 5));
c1.insert(Mymap::value_type('a', 6));
for (Mymap::const_iterator it = c1.begin();
it != c1.end(); ++it)
std::cout << " [" << it->first << ", " << it->second << "]";
std::cout << std::endl;
// The templatized versions move constructing elements
unordered_multimap<int, string> c3, c4;
pair<int, string> is1(1, "a"), is2(2, "b");
c3.insert(move(is1));
cout << "After the move insertion, c3 contains:" << endl
<< " " << c3.begin()->first
<< " => " << c3.begin()->second
<< endl;
c4.insert(c4.begin(), move(is2));
cout << "After the move insertion, c4 contains:" << endl
<< " " << c4.begin()->first
<< " => " << c4.begin()->second
<< endl;
return (0);
}
Requisiti
intestazione: <unordered_map>
Spazio dei nomi: deviazione standard