std::multimap<Key,T,Compare,Allocator>:: emplace

Inserta un nuevo elemento en el contenedor construido in-situ con los args dados.

El constructor del nuevo elemento (es decir, std:: pair < const Key, T > ) se llama exactamente con los mismos argumentos suministrados a emplace , reenviados mediante std:: forward < Args > ( args ) ... .

Si value_type no es EmplaceConstructible en multimap desde args , el comportamiento es indefinido.

No se invalidan iteradores ni referencias.

Parámetros

Valor de retorno

Un iterador al elemento insertado.

Excepciones

Si se lanza una excepción por cualquier razón, esta función no tiene efecto ( strong exception safety guarantee ).

Complejidad

Logarítmico en el tamaño del contenedor.

Notas

El uso cuidadoso de emplace permite construir el nuevo elemento evitando operaciones innecesarias de copia o movimiento.

Ejemplo

#include <iostream>
#include <string>
#include <utility>
#include <map>
int main()
{
    std::multimap<std::string, std::string> m;
    // utiliza el constructor de movimiento de pair
    m.emplace(std::make_pair(std::string("a"), std::string("a")));
    // utiliza el constructor de movimiento de conversión de pair
    m.emplace(std::make_pair("b", "abcd"));
    // utiliza el constructor de plantilla de pair
    m.emplace("d", "ddd");
    // emplace con clave duplicada
    m.emplace("d", "DDD");
    // utiliza el constructor por piezas de pair
    m.emplace(std::piecewise_construct,
              std::forward_as_tuple("c"),
              std::forward_as_tuple(10, 'c'));
    for (const auto& p : m)
        std::cout << p.first << " => " << p.second << '\n';
}

a => a
b => abcd
c => cccccccccc
d => ddd
d => DDD

Véase también