unordered_multimap::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 em não ordenada. |
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.
Comentários
Nenhuma referência para os elementos do contêiner for invalidada por essa função, mas pode invalidar todos os iteradores ao contêiner.
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_multimap <deCabeçalho: >
Namespace: std