unordered_set::Insert
Adiciona elementos.
std::pair<iterator, bool> insert(const value_type& val);
iterator insert(iterator where, const value_type& val);
template<class InIt>
void insert(InIt first, InIt last);
Parâmetros
InIt
O tipo de iterador.first
Início do intervalo para inserir.last
participante do intervalo para inserir.val
Valor a inserir.where
Onde no contêiner para inserir (Dica).
Comentários
A primeira função de membro determina se um elemento X existe na sequência cuja chave tem pedidos equivalente do val. Caso contrário, ele cria como um elemento X e o inicializa com val. A função, em seguida, determina o iterador where Designa que X. Se uma inserção ocorreu, a função retornará std::pair(where, true). Caso contrário, retornará std::pair(where, false).
A segunda função de membro retorna insert(val).first, usando where sistema autônomo um ponto de partida na sequência controlado para procurar o ponto de inserção. (Inserção pode possivelmente ocorrer um pouco mais rapidamente, se o ponto de inserção segue ou precede imediatamentewhere.) A terceira função de membro insere a sequência de valores de elemento para cada where no intervalo [first, last), chamando insert(*where).
Se uma exceção for gerada durante a inserção de um único elemento, o contêiner é deixado inalterado e a exceção é relançada.Se uma exceção for gerada durante a inserção de elementos múltiplos, o contêiner é deixado em um estado estável, mas não especificado e a exceção é relançada.
Exemplo
// std_tr1__unordered_set__unordered_set_insert.cpp
// compile with: /EHsc
#include <unordered_set>
#include <iostream>
typedef std::tr1::unordered_set<char> Myset;
int main()
{
Myset c1;
c1.insert('a');
c1.insert('b');
c1.insert('c');
// display contents " [c] [b] [a]"
for (Myset::const_iterator it = c1.begin();
it != c1.end(); ++it)
std::cout << " [" << *it << "]";
std::cout << std::endl;
// insert with hint and reinspect
Myset::iterator it2 = c1.insert(c1.begin(), 'd');
for (Myset::const_iterator it = c1.begin();
it != c1.end(); ++it)
std::cout << " [" << *it << "]";
std::cout << std::endl;
// insert range and inspect
Myset c2;
c2.insert(c1.begin(), c1.end());
for (Myset::const_iterator it = c2.begin();
it != c2.end(); ++it)
std::cout << " [" << *it << "]";
std::cout << std::endl;
// insert with checking and reinspect
std::pair<Myset::iterator, bool> pib =
c1.insert('e');
std::cout << "insert(['a',]) success == "
<< std::boolalpha << pib.second << std::endl;
pib = c1.insert('a');
std::cout << "insert(['a',]) success == "
<< std::boolalpha << pib.second << std::endl;
for (Myset::const_iterator it = c1.begin();
it != c1.end(); ++it)
std::cout << " [" << *it << "]";
std::cout << std::endl;
return (0);
}
[c] [b] [a] [d] [c] [b] [a] [d] [c] [b] [a] insert(['a',]) success == true insert(['a',]) success == false [e] [d] [c] [b] [a]
Requisitos
Cabeçalho:<unordered_set>
Namespace: std::tr1