unordered_set::emplace
Adiciona um elemento construído no lugar.
template<class ValTy>
pair<iterator, bool> emplace(ValTy&& val);
Parâmetros
Parâmetro |
Descrição |
ValTy |
O tipo de argumento do construtor in loco. |
val |
Valor a ser inserido. |
Comentários
A função de membro determina se um elemento X existe na seqüência cuja chave tem pedidos equivalente do val.Se não, ele constrói a esse elemento X com val.A função, em seguida, determina o iterador where que designa X.Se uma inserção ocorreu, a função retornará std::pair(where, true).Caso contrário, ele retornará std::pair(where, false).
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_set__unordered_set_emplace.cpp
// compile with: /EHsc
#include <unordered_set>
#include <iostream>
#include <string>
int main()
{
unordered_set< string> c1;
string str1("a");
c1.emplace(move(str1));
cout << "After the emplace insertion, c1 contains: "
<< *c1.begin() << endl;
return (0);
}
Requisitos
Cabeçalho: <unordered_set>
Namespace: std