std::unordered_map<Key,T,Hash,KeyEqual,Allocator>:: insert_range
|
template
<
container-compatible-range
<
value_type
>
R
>
void insert_range ( R && rg ) ; |
(desde C++23)
(constexpr desde C++26) |
|
Inserta una copia de cada elemento en el rango rg si y solo si no existe ningún elemento con clave equivalente a la clave de ese elemento en * this .
Cada iterador en el rango rg es desreferenciado exactamente una vez.
Si se satisface cualquiera de las siguientes condiciones, el comportamiento es indefinido:
-
value_typeno es EmplaceConstructible enunordered_mapdesde * ranges:: begin ( rg ) - rg y * this se superponen.
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
| rg | - |
un
rango compatible con contenedor
, es decir, un
input_range
cuyos elementos son convertibles a
T
|
Complejidad
Caso promedio N , caso peor O(N·S+N) , donde S es size ( ) y N es ranges:: distance ( rg ) .
Notas
| Macro de prueba de características | Valor | Std | Característica |
|---|---|---|---|
__cpp_lib_containers_ranges
|
202202L
|
(C++23) | Construcción e inserción compatibles con rangos |
Ejemplo
#include <iostream> #include <unordered_map> #include <utility> void println(auto, const auto& container) { for (const auto& [key, value] : container) std::cout << '{' << key << ',' << value << '}' << ' '; std::cout << '\n'; } int main() { auto container = std::unordered_map{std::pair{1, 11}, {3, 33}, {2, 22}, {4, 44}}; const auto rg = {std::pair{-1, -11}, {3, -33}, {-2, -22}}; #ifdef __cpp_lib_containers_ranges container.insert_range(rg); #else container.insert(rg.begin(), rg.end()); #endif println("{}", container); }
Salida posible:
{4,44} {-1,-11} {2,22} {3,33} {-2,-22} {1,11}
Véase también
|
inserta elementos
o nodos
(desde C++17)
(función miembro pública) |