std::unordered_multiset<Key,Hash,KeyEqual,Allocator>::unordered_multiset - cppreference.com
|
|
(1) | (desde C++11) |
|
|
(1) | (desde C++14) |
|
|
(1) | (desde C++11) |
|
|
(2) | (desde C++11) |
|
|
(2) | (desde C++14) |
|
|
(2) | (desde C++14) |
|
|
(3) | (desde C++11) |
|
|
(3) | (desde C++11) |
|
|
(4) | (desde C++11) |
|
|
(4) | (desde C++11) |
|
|
(5) | (desde C++11) |
|
|
(5) | (desde C++14) |
|
|
(5) | (desde C++14) |
Construye un nuevo contenedor a partir de una variedad de fuentes de datos. Opcionalmente utiliza una cuenta de depósitos, bucket_count, suministrada por el usuario como el número mínimo de depósitos a crear, hash como la función de dispersión, equal como la función para comparar claves y alloc como el asignador de memoria.
1) Construye un contenedor vacío. Establece max_load_factor() a 1.0. Para el constructor por defecto, el número de depósitos está definido por la implementación.
2) Construye el contenedor con el contenido del rango [first, last). Establece max_load_factor() a 1.0.
3) Constructor de copia. Construye el contenedor con la copia del contenido de other, también copia el factor de carga, el predicado, y la función de dispersión. Si no se proporciona alloc, el asignador de memoria se obtiene llamando a std::allocator_traits<allocator_type>::select_on_container_copy_construction(other.get_allocator()).
4) Constructor de movimiento. Construye el contenedor con el contenido de other usando la semántica de movimiento. Si no se proporciona alloc el asignador de memoria se obtiene mediante la construccón por movimiento del asignador que pertenece a other.
5) Construye el contenedor con el contenido de la lista de inicializadores init, lo mismo que unordered_multiset(init.begin(), init.end()).
Parámetros
| alloc | - | Asignador de memoria a usar para todas las asignaciones de memoria de este contenedor. |
| bucket_count | - | Número mínimo de depósitos a usar en la inicialización. Si no se especifica, se usa el valor por defecto definido por la implementación. |
| hash | - | Función de dispersión a usar. |
| equal | - | Función de comparación a usar para todas las comparaciones de claves de este contenedor. |
| first, last | - | El rango del cual copiar los elementos. |
| other | - | Otro contenedor a usar como fuente con el cual inicializar los elementos del contenedor. |
| init | - | Lista de inicializadores con la cual inicializar los elementos del contenedor. |
| Requisitos de tipo | ||
-InputIt debe satisfacer los requisitos de InputIterator.
| ||
Complejidad
1) Constante.
2) Lineal en el caso promedio, cuadrática en el peor de los casos en la distancia entre first y last.
3) Lineal de acuerdo al tamaño de other.
4) Constante. Si se da alloc y alloc != other.get_allocator(), entonces lineal.
5) Lineal en el caso promedio, cuadrática en el peor de los casos de acuerdo al tamaño de init.
Excepciones
Las llamadas a Allocator::allocate pueden lanzar.
Notas
Después de la construcción por movimiento de un contenedor (la sobrecarga (4)), las referencias, punteros e iteradores (aparte del iterador al final) a other permanecen válidos, pero se refieren a los elementos que ahora se encuentran en *this. El estándar actual da esta garantía vía la generalización en [container.requirements.general]/12, y una garantía más directa está bajo consideración vía LWG 2321.
Aunque no se requiere formalmente hasta C++23, algunas implementaciones ya han puesto el parámetro de plantilla Allocator en los contextos no deducidos en modalidades más tempranas.
Ejemplo
Informes de defectos
Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.
| ID | Aplicado a | Comportamiento según lo publicado | Comportamiento correcto |
|---|---|---|---|
| LWG 2193 | C++11 | El constructor por defecto es explicit.
|
Se hizo no explicit.
|