std::set<Key,Compare,Allocator>:: set
| (1) | ||
|
set
(
)
;
|
(hasta C++11) | |
|
set
(
)
:
set
(
Compare
(
)
)
{
}
|
(desde C++11)
(constexpr desde C++26) |
|
|
explicit
set
(
const
Compare
&
comp,
const Allocator & alloc = Allocator ( ) ) ; |
(2) | (constexpr desde C++26) |
|
explicit
set
(
const
Allocator
&
alloc
)
;
|
(3) |
(desde C++11)
(constexpr desde C++26) |
|
template
<
class
InputIt
>
set
(
InputIt first, InputIt last,
|
(4) | (constexpr desde C++26) |
|
template
<
class
InputIt
>
set
(
InputIt first, InputIt last,
|
(5) |
(desde C++14)
(constexpr desde C++26) |
|
set
(
const
set
&
other
)
;
|
(6) | (constexpr desde C++26) |
|
set
(
const
set
&
other,
const
Allocator
&
alloc
)
;
|
(7) |
(desde C++11)
(constexpr desde C++26) |
|
set
(
set
&&
other
)
;
|
(8) |
(desde C++11)
(constexpr desde C++26) |
|
set
(
set
&&
other,
const
Allocator
&
alloc
)
;
|
(9) |
(desde C++11)
(constexpr desde C++26) |
|
set
(
std::
initializer_list
<
value_type
>
init,
const
Compare
&
comp
=
Compare
(
)
,
|
(10) |
(desde C++11)
(constexpr desde C++26) |
|
set
(
std::
initializer_list
<
value_type
>
init,
const
Allocator
&
alloc
)
|
(11) |
(desde C++14)
(constexpr desde C++26) |
|
template
<
container-compatible-range
<
value_type
>
R
>
set
(
std::
from_range_t
, R
&&
rg,
|
(12) |
(desde C++23)
(constexpr desde C++26) |
|
template
<
container-compatible-range
<
value_type
>
R
>
set
(
std::
from_range_t
, R
&&
rg,
|
(13) |
(desde C++23)
(constexpr desde C++26) |
Construye un nuevo contenedor a partir de diversas fuentes de datos y opcionalmente utilizando el asignador de memoria proporcionado por el usuario alloc o el objeto función de comparación comp .
[
first
,
last
)
.
|
Si
alloc
no es proporcionado, el asignador se obtiene llamando a
std::
allocator_traits
<
allocator_type
>
::
|
(desde C++11) |
|
Durante la
deducción de argumentos de plantilla de clase
, solo el primer argumento contribuye a la deducción del parámetro de plantilla
|
(desde C++23) |
|
Durante la
deducción de argumentos de plantilla de clase
, solo el primer argumento contribuye a la deducción del parámetro de plantilla
|
(desde C++23) |
Contenidos |
Parámetros
| alloc | - | asignador a utilizar para todas las asignaciones de memoria de este contenedor |
| comp | - | objeto función de comparación para usar en todas las comparaciones de claves |
| first, last | - | el par de iteradores que define el rango fuente de elementos a copiar |
| other | - | otro contenedor que se utilizará como fuente para inicializar los elementos del contenedor |
| init | - | lista de inicialización para inicializar los elementos del contenedor |
| rg | - |
un
rango compatible con contenedor
, es decir, un
input_range
cuyos elementos son convertibles a
value_type
|
| Requisitos de tipo | ||
-
InputIt
debe cumplir con los requisitos de
LegacyInputIterator
.
|
||
-
Compare
debe cumplir con los requisitos de
Compare
.
|
||
-
Allocator
debe cumplir con los requisitos de
Allocator
.
|
||
Complejidad
[
first
,
last
)
ya está ordenado por
value_comp
(
)
.
Excepciones
Las llamadas a
Allocator::allocate
pueden lanzar excepciones.
Notas
Después de la construcción por movimiento del contenedor (sobrecarga ( 8,9 ) ), las referencias, punteros e iteradores (excepto el iterador final) a other permanecen válidos, pero se refieren a elementos que ahora están en * this . El estándar actual garantiza esto mediante la declaración general en [container.reqmts]/67 , y se está considerando una garantía más directa a través de LWG issue 2321 .
Si múltiples elementos en el rango tienen claves que son equivalentes, no está especificado qué elemento se inserta (pendiente de LWG2844 ).
Aunque no es formalmente requerido hasta C++23, algunas implementaciones ya han colocado el parámetro de plantilla
Allocator
en
contextos no deducidos
en modos anteriores.
| 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; sobrecargas ( 12,13 ) |
Ejemplo
#include <cmath> #include <iostream> #include <set> #include <string> struct Point { double x, y; }; struct PointCmp { bool operator()(const Point& lhs, const Point& rhs) const { return std::hypot(lhs.x, lhs.y) < std::hypot(rhs.x, rhs.y); } }; std::ostream& operator<<(std::ostream& os, Point pt) { return os << '(' << pt.x << ',' << pt.x << ')'; } void println(auto rem, const auto& seq) { std::cout << rem << '{'; for (auto n{seq.size()}; const auto& elm : seq) std::cout << elm << (--n ? ", " : ""); std::cout << "}\n"; } int main() { // (1) Constructor por defecto std::set<std::string> a; a.insert("horse"); a.insert("cat"); a.insert("dog"); println("1) a: ", a); // (4) Constructor de rango std::set<std::string> b(a.find("dog"), a.end()); println("2) b: ", b); // (6) Constructor de copia std::set<std::string> c(a); c.insert("another horse"); println("3) c: ", c); // (8) Constructor de movimiento std::set<std::string> d(std::move(a)); println("4) d: ", d); println("5) a: ", a); // (10) Constructor de lista de inicialización std::set<std::string> e{"one", "two", "three", "five", "eight"}; println("6) e: ", e); // Comparación personalizada std::set<Point, PointCmp> f = {{2, 5}, {3, 4}, {1, 1}}; f.insert({1, -1}); // Esto falla porque la magnitud de (1,-1) es igual a (1,1) println("7) f: ", f); // (12) Constructor de rango const auto w = {"Eurybia", "Theia", "Rhea", "Aura", "Mnemosyne", "Mnemosyne"}; #if __cpp_lib_containers_ranges std::set<std::string> g(std::from_range, w); // sobrecarga (12) #else std::set<std::string> g(w.begin(), w.end()); // alternativa a (4) #endif println("8) g: ", g); }
Salida posible:
1) a: {cat, dog, horse}
2) b: {dog, horse}
3) c: {another horse, cat, dog, horse}
4) d: {cat, dog, horse}
5) a: {}
6) e: {eight, five, one, three, two}
7) f: {(1,1), (3,3), (2,2)}
8) g: {Aura, Eurybia, Mnemosyne, Rhea, Theia}
Informes de defectos
Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.
| DR | Aplicado a | Comportamiento publicado | Comportamiento correcto |
|---|---|---|---|
| LWG 2076 | C++11 |
sobrecarga
(
4
)
requería condicionalmente que
Key
fuera
CopyInsertable
en
*
this
|
no requerido |
| LWG 2193 | C++11 | el constructor por defecto era explícito | hecho no-explícito |
Véase también
|
asigna valores al contenedor
(función miembro pública) |