Bibliothèque C ++ Unordered_map - fonction emplace ()

La description

La fonction C ++ std::unordered_map::emplace() étend le conteneur en insérant un nouvel élément.

l'insertion n'a lieu que si la clé n'est pas déjà présente.

Déclaration

Voici la déclaration de la fonction std :: unordered_map :: emplace () de l'en-tête std :: unordered_map.

C ++ 11

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

Paramètres

args - Arguments à transmettre au constructeur de l'élément.

Valeur de retour

Renvoie une paire composée de booléens pour indiquer si l'insertion a eu lieu ou non et renvoie un itérateur à l'élément nouvellement inséré.

Complexité temporelle

Constante ie O (1) dans le cas moyen.

Linéaire c'est-à-dire O (n) dans le pire des cas.

Exemple

L'exemple suivant montre l'utilisation de la fonction std :: unordered_map :: emplace ().

#include <iostream>
#include <unordered_map>

using namespace std;

int main(void) {
   unordered_map<char, int> um;

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

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

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

   return 0;
}

Compilons et exécutons le programme ci-dessus, cela produira le résultat suivant -

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