C ++ Map Library - Funzione emplace_hint ()

Descrizione

La funzione C ++ std::multimap::emplace_hint() inserisce un nuovo elemento in una mappa multipla utilizzando il suggerimento come posizione per l'elemento.

Dichiarazione

Di seguito è riportata la dichiarazione per la funzione std :: multimap :: emplace_hint () nel modulo std :: map header.

C ++ 11

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

Parametri

  • position - Suggerimento per la posizione in cui inserire l'elemento.

  • args - Argomenti inoltrati per costruire il nuovo elemento.

Valore di ritorno

Restituisce un iteratore all'elemento appena inserito.

Eccezioni

Nessun effetto sul contenitore se viene generata un'eccezione.

Complessità temporale

Logaritmico ie O (log n)

Esempio

L'esempio seguente mostra l'utilizzo della funzione 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;
}

Compiliamo ed eseguiamo il programma sopra, questo produrrà il seguente risultato:

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