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

Descrição

A função C ++ std::map::emplace_hint() insere um novo elemento em um mapa usando dica como uma posição para o elemento.

Declaração

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

C ++ 11

template <class... Args>
iterator emplace_hint (const_iterator position, Args&&... args);

Parâmetros

  • position - Dica para a posição de inserção do elemento.

  • args - Argumentos encaminhados para construir o novo elemento.

Valor de retorno

Retorna um iterador para o elemento recém-inserido. Se a inserção falhar devido a um elemento já existente, ele retornará o iterador para o elemento existente.

Exceções

Esta função de membro não lança exceção.

Complexidade de tempo

Linear, ou seja, O (n)

Exemplo

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

#include <iostream>
#include <map>

using namespace std;

int main(void) {
   map<char, int> m = {
            {'b', 2},
            {'c', 3},
            {'d', 4},
            };

   m.emplace_hint(m.end(), 'e', 5);
   m.emplace_hint(m.begin(), 'a', 1);

   cout << "Map contains following elements" << 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
a = 1
b = 2
c = 3
d = 4
e = 5