std::unordered_multiset<Key,Hash,KeyEqual,Allocator>:: emplace

template < class ... Args > iterator emplace ( Args && ... args ) ;		(desde C++11) (constexpr desde C++26)

Inserta un nuevo elemento en el contenedor construido in-situ con los args dados.

El constructor del nuevo elemento se llama exactamente con los mismos argumentos suministrados a emplace , reenviados mediante std:: forward < Args > ( args ) ... .

Si value_type no es EmplaceConstructible en unordered_multiset desde args , el comportamiento es indefinido.

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 1 Parámetros 2 Valor de retorno 3 Excepciones 4 Complejidad 5 Notas 6 Ejemplo 7 Véase también

Parámetros

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.

Notas

El uso cuidadoso de emplace permite construir el nuevo elemento evitando operaciones innecesarias de copia o movimiento.

Ejemplo

Esta sección está incompleta Razón: sin ejemplo

Véase también

emplace_hint	construye elementos in-situ usando una pista (función miembro pública)
insert	inserta elementos o nodos (desde C++17) (función miembro pública)