Biblioteca C ++ Unordered_map - función emplace ()

Descripción

La función C ++ std::unordered_map::emplace() extiende el contenedor insertando un nuevo elemento.

la inserción se lleva a cabo solo y solo si la clave aún no está presente.

Declaración

A continuación se muestra la declaración de la función std :: unordered_map :: emplace () del encabezado std :: unordered_map.

C ++ 11

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

Parámetros

args - Argumentos para reenviar al constructor del elemento.

Valor devuelto

Devuelve un par que consta de bool para indicar si se realizó la inserción o no y devuelve un iterador al elemento recién insertado.

Complejidad del tiempo

Constante, es decir, O (1) en caso medio.

Lineal, es decir, O (n) en el peor de los casos.

Ejemplo

El siguiente ejemplo muestra el uso de la función 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;
}

Compilemos y ejecutemos el programa anterior, esto producirá el siguiente resultado:

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