set::emplace

Insere um elemento construído no lugar (nenhuma operação de cópia ou movimentação é executada).

template<class... Args>
    pair<iterator, bool> emplace(
        Args&&... args
);

Parâmetros

Parâmetro	Descrição
args	Os argumentos encaminhados para construir um elemento a ser inserido no conjunto a menos que já contenha um elemento cujo valor está ordenado equivalente.

Valor de retorno

par cujo componente de bool retornará true se uma inserção tiver sido feita, e false se o mapa já contiver um elemento cujo valor tem um valor equivalente na ordenação. O componente de iterador de pares do valor de retorno retorna o endereço onde um novo elemento foi inserido (se o componente de bool é verdadeiro) ou onde o elemento esteve encontrado já (se o componente de bool false) é.

Comentários

Nenhuma iterador ou referência são invalidados por essa função.

Durante a inserção, se uma exceção é gerada, o estado do contêiner não é alterado.

Exemplo

// set_emplace.cpp
// compile with: /EHsc
#include <set>
#include <string>
#include <iostream>

using namespace std;

template <typename S> void print(const S& s) {
    cout << s.size() << " elements: ";

    for (const auto& p : s) {
        cout << "(" << p << ") ";
    }

    cout << endl;
}

int main()
{
    set<string> s1;

    auto ret = s1.emplace("ten");

    if (!ret.second){
        cout << "Emplace failed, element with value \"ten\" already exists."
            << endl << "  The existing element is (" << *ret.first << ")"
            << endl;
        cout << "set not modified" << endl;
    }
    else{
        cout << "set modified, now contains ";
        print(s1);
    }
    cout << endl;

    ret = s1.emplace("ten");

    if (!ret.second){
        cout << "Emplace failed, element with value \"ten\" already exists."
            << endl << "  The existing element is (" << *ret.first << ")"
            << endl;
    }
    else{
        cout << "set modified, now contains ";
        print(s1);
    }
    cout << endl;
}

Saída

set modified, now contains 1 elements: (ten)

Emplace failed, element with value "ten" already exists.
  The existing element is (ten)

Requisitos

defineCabeçalho: <>

Namespace: std

Consulte também

Referência

<set>

Classe set

Biblioteca de Modelos Padrão