Biblioteca de mapas C ++ - função emplace ()

Descrição

A função C ++ std::map::emplace() estende o contêiner inserindo um novo elemento.

A inserção ocorre apenas e somente se a chave ainda não estiver presente.

Declaração

A seguir está a declaração para o cabeçalho da função std :: map :: emplace () std :: map.

C ++ 11

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

Parâmetros

args - argumentos a serem encaminhados ao construtor do elemento.

Valor de retorno

Retorna um par que consiste em bool para indicar se a inserção ocorreu ou não e retorna um iterador para o elemento recém-inserido.

Exceções

Se uma exceção é lançada por qualquer operação, esta função não tem efeito.

Complexidade de tempo

Logarítmico, ou seja, log (n)

Exemplo

O exemplo a seguir mostra o uso da função std :: map :: emplace ().

#include <iostream>
#include <map>

using namespace std;

int main(void) {
   /* Initializer_list constructor */
   map<char, int> m;

   m.emplace('a', 1);
   m.emplace('b', 2);
   m.emplace('c', 3);
   m.emplace('d', 4);
   m.emplace('e', 5);

   cout << "Map contains following elements in reverse order" << endl;

   for (auto it = m.begin(); it != m.end(); ++it)
      cout << it->first << " = " << it->second << endl;

   return 0;
}

Vamos compilar e executar o programa acima, isso produzirá o seguinte resultado -

Map contains following elements in reverse order
a = 1
b = 2
c = 3
d = 4
e = 5