std::unordered_set<Key,Hash,KeyEqual,Allocator>:: emplace
|
template
<
class
...
Args
>
std:: pair < iterator, bool > emplace ( Args && ... args ) ; |
(desde C++11)
(constexpr desde C++26) |
|
Inserta un nuevo elemento en el contenedor construido in-situ con los args dados, si no existe ningún elemento con la clave en el contenedor.
El constructor del nuevo elemento se llama exactamente con los mismos argumentos suministrados a
emplace
, reenviados mediante
std::
forward
<
Args
>
(
args
)
...
.
El elemento puede construirse incluso si ya existe un elemento con la misma clave en el contenedor, en cuyo caso el elemento recién construido será destruido inmediatamente.
Si
value_type
no es
EmplaceConstructible
en
unordered_set
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 |
Parámetros
| args | - | argumentos para reenviar al constructor del elemento |
Valor de retorno
Un par que consiste en un iterador al elemento insertado (o al elemento que impidió la inserción) y un valor bool establecido en true si y solo si la inserción tuvo lugar.
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
|
construye elementos in-situ usando una pista
(función miembro pública) |
|
|
inserta elementos
o nodos
(desde C++17)
(función miembro pública) |