std::unordered_set<Key,Hash,KeyEqual,Allocator>:: insert
|
std::
pair
<
iterator,
bool
>
insert
(
const
value_type
&
value
)
;
|
(1) | (desde C++11) |
|
std::
pair
<
iterator,
bool
>
insert
(
value_type
&&
value
)
;
|
(2) | (desde C++11) |
|
iterator insert
(
const_iterator hint,
const
value_type
&
value
)
;
|
(3) | (desde C++11) |
|
iterator insert
(
const_iterator hint, value_type
&&
value
)
;
|
(4) | (desde C++11) |
|
template
<
class
InputIt
>
void insert ( InputIt first, InputIt last ) ; |
(5) | (desde C++11) |
|
void
insert
(
std::
initializer_list
<
value_type
>
ilist
)
;
|
(6) | (desde C++11) |
|
insert_return_type insert
(
node_type
&&
nh
)
;
|
(7) | (desde C++17) |
|
iterator insert
(
const_iterator hint, node_type
&&
nh
)
;
|
(8) | (desde C++17) |
|
template
<
class
K
>
std:: pair < iterator, bool > insert ( K && obj ) ; |
(9) | (desde C++23) |
|
template
<
class
K
>
iterator insert ( const_iterator hint, K && obj ) ; |
(10) | (desde C++23) |
Inserta elemento(s) en el contenedor, si el contenedor no contiene ya un elemento con una clave equivalente.
[
first
,
last
)
. Si múltiples elementos en el rango tienen claves que son equivalentes, no está especificado qué elemento se inserta (pendiente de
LWG2844
).
u
de
value_type
con
std::
forward
<
K
>
(
obj
)
y luego inserta
u
en
*
this
. Si
equal_range
(
u
)
!
=
hash_function
(
)
(
obj
)
||
contains
(
u
)
es
true
, el comportamiento es indefinido. El
value_type
debe ser
EmplaceConstructible
en
unordered_set
desde
std::
forward
<
K
>
(
obj
)
. Esta sobrecarga participa en la resolución de sobrecarga solo si
Hash
y
KeyEqual
son ambos
transparentes
. Esto asume que dicho
Hash
puede ser invocado tanto con el tipo
K
como con el tipo
Key
, y que el
KeyEqual
es transparente, lo que, en conjunto, permite llamar a esta función sin construir una instancia de
Key
.
En caso contrario, construye un objeto
u
de tipo
value_type
con
std::
forward
<
K
>
(
obj
)
y luego inserta
u
en
*
this
.
Template:hint
se utiliza como sugerencia no vinculante sobre dónde debería comenzar la búsqueda. Si
equal_range
(
u
)
!
=
hash_function
(
)
(
obj
)
||
contains
(
u
)
es
true
, el comportamiento es indefinido.
El
value_type
debe ser
EmplaceConstructible
en
unordered_set
desde
std::
forward
<
K
>
(
obj
)
. Esta sobrecarga participa en la resolución de sobrecarga solo si:
- std:: is_convertible_v < K && , const_iterator > y std:: is_convertible_v < K && , iterator > son ambos false , y
-
Hash
::
is_transparent
y
KeyEqual
::
is_transparent
son válidos y cada uno denota un tipo. Esto asume que dicho
Hashes invocable tanto con el tipoKcomo con el tipoKey, y que elKeyEquales transparente,
Key
.
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.
Si la inserción es exitosa, los punteros y referencias al elemento obtenidos mientras se mantiene en el manejador de nodo se invalidan, y los punteros y referencias obtenidos para ese elemento antes de ser extraído pasan a ser válidos.
(desde C++17)
Contenidos |
Parámetros
| hint | - | iterador, utilizado como sugerencia sobre dónde insertar el contenido |
| value | - | valor del elemento a insertar |
| first, last | - | el par de iteradores que define el rango fuente de elementos a insertar |
| ilist | - | lista de inicializadores de la cual insertar los valores |
| nh | - | un node handle compatible |
| obj | - | un valor de cualquier tipo que pueda compararse transparentemente con una clave |
| Requisitos de tipo | ||
-
InputIt
debe cumplir con los requisitos de
LegacyInputIterator
.
|
||
Valor de retorno
insert_return_type
con los miembros inicializados de la siguiente manera:
-
Si
nh
está vacío,
insertedes false ,positiones end ( ) , ynodeestá vacío. -
En caso contrario, si la inserción tuvo lugar,
insertedes true ,positionapunta al elemento insertado, ynodeestá vacío. -
Si la inserción falló,
insertedes false ,nodetiene el valor previo de nh , ypositionapunta a un elemento con una clave equivalente a nh. key ( ) .
Excepciones
|
Esta sección está incompleta
Razón: casos 5-10 |
Complejidad
O(1)
, caso peor
O(size())
.
O(N)
, donde N es el número de elementos a insertar. Caso peor:
O(N * size() + N)
.
O(1)
, caso peor
O(size())
.
Notas
La inserción con sugerencia
(
(
3,4
)
,
(
8
)
y
(
10
)
)
no retorna un booleano para ser compatible en firma con la inserción posicional en contenedores secuenciales, como
std::vector::insert
. Esto hace posible crear insertores genéricos como
std::inserter
. Una forma de verificar el éxito de una inserción con sugerencia es comparar
size()
antes y después.
| Macro de prueba de características | Valor | Std | Característica |
|---|---|---|---|
__cpp_lib_associative_heterogeneous_insertion
|
202311L
|
(C++26) | Sobrecargas heterogéneas para las funciones miembro restantes en contenedores asociativos ordenados y contenedores asociativos no ordenados . ( 9,10 ) |
Ejemplo
#include <array> #include <iostream> #include <unordered_set> std::ostream& operator<<(std::ostream& os, std::unordered_set<int> const& s) { for (os << '[' << s.size() << "] { "; int i : s) os << i << ' '; return os << "}\n"; } int main () { std::unordered_set<int> nums{2, 3, 4}; std::cout << "1) Initially: " << nums << std::boolalpha; auto p = nums.insert(1); // insert element, overload (1) std::cout << "2) '1' was inserted: " << p.second << '\n'; std::cout << "3) After insertion: " << nums; nums.insert(p.first, 0); // insert with hint, overload (3) std::cout << "4) After insertion: " << nums; std::array<int, 4> a = {10, 11, 12, 13}; nums.insert(a.begin(), a.end()); // insert range, overload (5) std::cout << "5) After insertion: " << nums; nums.insert({20, 21, 22, 23}); // insert initializer_list, (6) std::cout << "6) After insertion: " << nums; std::unordered_set<int> other_nums = {42, 43}; auto node = other_nums.extract(other_nums.find(42)); nums.insert(std::move(node)); // insert node, overload (7) std::cout << "7) After insertion: " << nums; node = other_nums.extract(other_nums.find(43)); nums.insert(nums.begin(), std::move(node)); // insert node with hint, (8) std::cout << "8) After insertion: " << nums; }
Salida posible:
1) Initially: [3] { 4 3 2 }
2) '1' was inserted: true
3) After insertion: [4] { 1 2 3 4 }
4) After insertion: [5] { 0 1 2 3 4 }
5) After insertion: [9] { 13 12 11 10 4 3 2 1 0 }
6) After insertion: [13] { 23 22 13 12 11 10 21 4 20 3 2 1 0 }
7) After insertion: [14] { 42 23 22 13 12 11 10 21 4 20 3 2 1 0 }
8) After insertion: [15] { 43 42 23 22 13 12 11 10 21 4 20 3 2 1 0 }
Véase también
|
construye elemento in-situ
(función miembro pública) |
|
|
construye elementos in-situ usando una pista
(función miembro pública) |
|
|
crea un
std::insert_iterator
del tipo inferido del argumento
(plantilla de función) |