Compartilhar via


unordered_multimap::emplace

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(
      Args&&... args);

Parâmetros

Parâmetro

Descrição

args

Os argumentos encaminhados para construir um elemento a ser inserido em unordered_multimap.

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.

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.

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.

Para um exemplo de código, consulte multimap::emplace.

Requisitos

mapa <deCabeçalho: >

Namespace: std

Consulte também

Referência

<map>

Classe multimap

Biblioteca de Modelos Padrão