unordered_set::insert

Artigo
02/24/2013

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);
template<class ValTy>
    pair<iterator, bool> 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 no lugar do argumento do construtor.
first	Início do intervalo para inserir.
last	O final do intervalo para inserir.
val	Valores a serem inseridos.
where	Onde inserir dica no recipiente (somente).

Comentários

A primeira função de membro determina se um elemento X existe na seqüência cuja chave tem o equivalente de ordenação da val.Caso contrário, crie um elemento X e inicializá-la com val.A função determina o iterador where que designa X.Se uma inserção ocorreu, a função retorna std::pair(where, true).Caso contrário, retornará std::pair(where, false).

A segunda função de membro retorna insert(val).first, usando where como um local inicial na seqüência controlada para procurar pelo ponto de inserção.(Inserção pode possivelmente ocorrer um pouco mais rapidamente, se o ponto de inserção imediatamente preceda ou maneira 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 duas funções de membro as mais recentes se comportam o mesmo que 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 recipiente é deixado inalterado e a exceção é rethrown.Se uma exceção é lançada durante a inserção de vários elementos, o recipiente é deixado em um estado estável mas não especificado e a exceção são rethrown.

Exemplo

// std_tr1__unordered_set__unordered_set_insert.cpp 
// compile with: /EHsc 
#include <unordered_set> 
#include <iostream>
#include <string> 
 
typedef std::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; 

// The templatized versions move constructing elements
    unordered_set<string> c3, c4;
    string str1("a"), str2("b");

    c3.insert(move(str1));
    cout << "After the move insertion, c3 contains: "
        << *c3.begin() << endl;

    c4.insert(c4.begin(), move(str2));
    cout << "After the move insertion, c4 contains: "
        << *c4.begin() << endl;
 
     return (0); 
    }

Requisitos

Cabeçalho: <unordered_set>

namespace: STD

Consulte também

Referência

<unordered_set>

unordered_set Class

Compartilhar via