unordered_map::emplace_hint
Insere um elemento construído no lugar (nenhuma operação de cópia ou movimentação é executada), com uma dica de posicionamento.
template<class... Args>
iterator emplace_hint(
const_iterator where,
Args&&... args);
Parâmetros
Parâmetro |
Descrição |
args |
Os argumentos encaminhados para construir um elemento a ser inserido mais comumente em unordered_map a menos que o unordered_map já contenha esse elemento, ou, a menos que já contenha um elemento cuja chave está ordenada equivalente. |
where |
Uma dica em relação ao local para iniciar a pesquisa pelo ponto de inserção correto. |
Valor de retorno
Um iterador ao elemento inserido recentemente.
Se a inserção falhou porque o elemento já existir, o retornará um iterador ao elemento existente.
Comentários
Nenhuma referência será invalidada por essa função.
Durante a inserção, se uma exceção é lançada mas não ocorre na função de hash de contêiner, o contêiner não é alterado. Se a exceção é lançada na função de hash, o resultado será indefinido.
value_type de um elemento é um par, de forma que o valor de um elemento é um par ordenado com o primeiro componente igual ao valor de chave e o segundo componente igual ao valor de dados do elemento.
Para um exemplo de código, consulte map::emplace_hint.
Requisitos
unordered_map <deCabeçalho: >
Namespace: std