hash_multimap::emplace_hint
Nota
Esta API está obsoleta.La alternativa es unordered_multimap (Clase).
Inserta un elemento construido en el lugar en un hash_multimap, con una sugerencia de posición.
template<class ValTy>
iterator emplace_hint(
const_iterator _Where,
ValTy&& _Val
);
Parámetros
Parámetro |
Descripción |
_Val |
El valor utilizado para mover la construcción un elemento en hash_multimap (Clase) a menos que hash_multimap ya contiene ese elemento (o, más general, un elemento cuya clave equivalente está ordenada). |
_Where |
Sugerencia con respecto al lugar donde se va a empezar a buscar el punto correcto de inserción. |
Valor devuelto
La función miembro de hash_multimap::emplace devuelve un iterador que señale a la posición donde el nuevo elemento se ha insertado en hash_multimap.
Comentarios
hash_multimap::value_type de un elemento es par, de modo que el valor de un elemento es un par petición con el primer componente igual al valor de clave y el segundo componente igual al valor de los datos de elemento.
Inserción puede aparecer en tiempo constante amortizado, en lugar de tiempo logarítmico, si el punto de inserción inmediatamente sigue _Where.
A partir de Visual C++ .NET 2003, los miembros de los archivos de encabezado de <hash_map> y de <hash_set> ya no están en el espacio de nombres std, pero se han movido bastante al espacio de nombres stdext. Vea El espacio de nombres stdext para obtener más información.
Ejemplo
// hash_multimap_emplace_hint.cpp
// compile with: /EHsc
#include<hash_multimap>
#include<iostream>
#include <string>
int main()
{
using namespace std;
using namespace stdext;
hash_multimap<int, string> hm1;
typedef pair<int, string> is1(1, "a");
hm1.emplace(hm1.begin(), move(is1));
cout << "After the emplace insertion, hm1 contains:" << endl
<< " " << hm1.begin()->first
<< " => " << hm1.begin()->second
<< endl;
}
Requisitos
Encabezado: <hash_map>
Espacio de nombres: stdext