std::unordered_multiset<Key,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.
Los constructores de la clave y el valor mapeado se llaman 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()
ocurre una redistribución (rehashing).
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) |