Biblioteca C ++ Unordered_map - Função emplace_hint ()

Descrição

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

Declaração

A seguir está a declaração para o formulário de função std :: unordered_map :: emplace_hint () cabeçalho std :: unordered_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.

Complexidade de tempo

Constante, isto é, O (1) no caso médio.

Linear, isto é, O (n) no pior caso.

Exemplo

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

#include <iostream>
#include <unordered_map>

using namespace std;

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

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

   cout << "Unordered map contains following elements" << endl;

   for (auto it = um.cbegin(); it != um.cend(); ++it)
      cout << it->first << " = " << it->second << endl;

   return 0;
}

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

Unordered map contains following elements
a = 1
e = 5
d = 4
b = 2
c = 3