unordered_multimap::insert
Adiciona elementos.
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);
Parâmetros
Parâmetro |
Descrição |
InIt |
O tipo de iterador. |
ValTy |
O tipo de argumento do construtor in loco. |
First |
Início do intervalo para inserir. |
Last |
Fim do intervalo para inserir. |
Val |
Valor a ser inserido. |
Where |
Onde no recipiente para inserir (somente Dica). |
Comentários
A primeira função de membro insere o elemento val na seqüência controlada, em seguida, retorna o iterador que designa o elemento inserido.A segunda função de membro retorna insert(val), usando where como um ponto de partida na seqüência controlado para procurar o ponto de inserção.(Inserção possivelmente pode ocorrer um pouco mais rapidamente, se o ponto de inserção imediatamente precede ou segue where.)
A terceira função de membro insere a seqüência de valores de elemento, para cada where no intervalo [first, last), chamando insert(*where).
As funções de membro últimas duas se comportam da mesma como os dois primeiros, exceto que val é usado para construir o valor inserido.
Se uma exceção é lançada durante a inserção de um único elemento, o contêiner é deixado inalterada e a exceção será emitida novamente.Se uma exceção é lançada durante a inserção de vários elementos, o contêiner é deixado em um estado estável, mas não especificado e a exceção será emitida novamente.
Exemplo
// 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);
}
Requisitos
Cabeçalho: <unordered_map>
Namespace: std