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

Descrição

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

Declaração

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

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.

Exceções

Nenhum efeito no contêiner se a exceção for lançada.

Complexidade de tempo

Logarítmico, ou seja, O (log n)

Exemplo

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

#include <iostream>
#include <map>

using namespace std;

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

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

   cout << "Multimap 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 -

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