std::set<Key,Compare,Allocator>:: swap
|
void
swap
(
set
&
other
)
;
|
(hasta C++17) | |
|
void
swap
(
set
&
other
)
noexcept
(
/* ver más abajo */
)
;
|
(desde C++17)
(constexpr desde C++26) |
|
Intercambia el contenido del contenedor con el de other . No invoca ninguna operación de movimiento, copia o intercambio en elementos individuales.
Todos los iteradores y referencias permanecen válidos. El iterador
end()
queda invalidado.
Compare
debe ser
Swappable
, y los objetos de este tipo se intercambian mediante llamada no calificada a la función no miembro
swap
.
|
Si
std::
allocator_traits
<
allocator_type
>
::
propagate_on_container_swap
::
value
es
true
, entonces los asignadores se intercambian mediante una llamada no calificada a la función no miembro
|
(desde C++11) |
Contenidos |
Parámetros
| otro | - | contenedor con el cual intercambiar los contenidos |
Excepciones
|
Cualquier excepción lanzada por el intercambio de los
objetos
|
(hasta C++17) |
|
noexcept
especificación:
noexcept
(
std::
allocator_traits
<
Allocator
>
::
is_always_equal
::
value
&& std:: is_nothrow_swappable < Compare > :: value ) |
(desde C++17) |
Complejidad
Constante.
Ejemplo
#include <functional> #include <iostream> #include <set> template<class Os, class Co> Os& operator<<(Os& os, const Co& co) { os << '{'; for (const auto& i : co) os << ' ' << i; return os << " } "; } int main() { std::set<int> a1{3, 1, 3, 2}, a2{5, 4, 5}; auto it1 = std::next(a1.begin()); auto it2 = std::next(a2.begin()); const int& ref1 = *(a1.begin()); const int& ref2 = *(a2.begin()); std::cout << a1 << a2 << *it1 << ' ' << *it2 << ' ' << ref1 << ' ' << ref2 << '\n'; a1.swap(a2); std::cout << a1 << a2 << *it1 << ' ' << *it2 << ' ' << ref1 << ' ' << ref2 << '\n'; // Nótese que cada iterador que hace referencia a un elemento en un contenedor antes del intercambio // hace referencia al mismo elemento en el otro contenedor después del intercambio. Lo mismo es válido // para las referencias. struct Cmp : std::less<int> { int id{}; Cmp(int i) : id{i} {} }; std::set<int, Cmp> s1{{2, 2, 1, 1}, Cmp{6}}, s2{{4, 4, 3, 3}, Cmp{9}}; std::cout << s1 << s2 << s1.key_comp().id << ' ' << s2.key_comp().id << '\n'; s1.swap(s2); std::cout << s1 << s2 << s1.key_comp().id << ' ' << s2.key_comp().id << '\n'; // Por lo tanto, los objetos comparadores (Cmp) también se intercambian después del swap. }
Salida:
{ 1 2 3 } { 4 5 } 2 5 1 4
{ 4 5 } { 1 2 3 } 2 5 1 4
{ 1 2 } { 3 4 } 6 9
{ 3 4 } { 1 2 } 9 6
Véase también
|
especializa el algoritmo
std::swap
(plantilla de función) |