std::unordered_multimap<Key,T,Hash,KeyEqual,Allocator>:: emplace_hint
|
template
<
class
...
Args
>
iterator emplace_hint ( const_iterator hint, Args && ... args ) ; |
(desde C++11)
(constexpr desde C++26) |
|
Inserta un nuevo elemento en el contenedor, usando hint como sugerencia de dónde debería ir el elemento.
El constructor de
value_type
(es decir,
std::
pair
<
const
Key, T
>
) se llama exactamente con los mismos argumentos suministrados a la función, reenviados con
std::
forward
<
Args
>
(
args
)
...
.
Si después de la operación el nuevo número de elementos es mayor que el antiguo
max_load_factor()
*
bucket_count()
se produce una redistribución.
Si ocurre redistribución (debido a la inserción), todos los iteradores quedan invalidados. En caso contrario (sin redistribución), los iteradores no se invalidan.
Contenidos |
Parámetros
| hint | - | iterador, utilizado como sugerencia sobre dónde insertar el nuevo elemento |
| args | - | argumentos para reenviar al constructor del elemento |
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
Constante amortizado en promedio, lineal en el peor caso según el tamaño del contenedor.
Ejemplo
|
Esta sección está incompleta
Razón: sin ejemplo |
Véase también
|
construye elementos in-situ
(función miembro pública) |
|
|
inserta elementos
o nodos
(desde C++17)
(función miembro pública) |