unordered_multimap::emplace

Agrega un elemento construido en contexto.

template<class ValTy>
    iterator emplace(ValTy&& val);

Parámetros

Parámetro	Descripción
ValTy	El tipo de contexto del argumento del constructor.
val	Valor que se va a insertar.

Comentarios

La función miembro construye un elemento X con valy devuelve el iterador que señala X.

Si se produce una excepción durante la inserción, el contenedor permanece inalterado y la excepción se reinician.

Ejemplo

// std_tr1__unordered_multimap__unordered_multimap_emplace.cpp 
// compile with: /EHsc 
#include <unordered_multimap> 
#include <iostream> 
#include <string>
 
int main() 
    { 
    using namespace std;
    unordered_multimap<int, string> c1;
    pair<int, string> is1(1, "a");

    c1.emplace(move(is1));
    cout << "After the emplace insertion, c1 contains:" << endl
      << " " << c1.begin()->first
      << " => " << c1.begin()->second
      << endl;

    return (0); 
    }