unordered_map::emplace_hint
Inserta un elemento construido en contexto (no se realiza ninguna operación de copia o de movimiento), con una sugerencia de colocación.
template<class... Args>
iterator emplace_hint(
const_iterator where,
Args&&... args);
Parámetros
Parámetro |
Descripción |
args |
Argumentos reenviados para construir un elemento que se va a insertar en el unordered_map a menos que el unordered_map ya contenga ese elemento o, más en general, a menos que ya contenga un elemento cuya clave esté ordenada de manera equivalente. |
where |
Sugerencia con respecto al lugar donde se va a empezar a buscar el punto correcto de inserción. |
Valor devuelto
Iterador al elemento recién insertado.
Si se produjo un error en la inserción porque el elemento ya existe, devuelve un iterador al elemento existente.
Comentarios
Esta función no invalida ninguna referencia.
Durante la inserción, si se produce una excepción pero no ocurre en la función hash del contenedor, el contenedor no se modifica. Si la excepción se produce en la función hash, el resultado es indefinido.
El value_type de un elemento es un par, de modo que el valor de un elemento será un par ordenado en el que el primer componente es igual que el valor de clave y el segundo componente es igual que el valor de datos del elemento.
Para obtener un ejemplo de código, vea map::emplace_hint.
Requisitos
Encabezado: <unordered_map>
Espacio de nombres: std