std::set<Key,Compare,Allocator>::swap
void swap( set& other ); |
(hasta C++17) | |
void swap( set& other ) noexcept(/* véase más abajo */); |
(desde C++17) | |
Intercambia el contenido del contenedor con el de other. No invoca ninguna operación de movimiento, copia o intercambio en los elementos individuales.
Todos los iteradores y las referencias se mantienen válidos. Se invalida el iterador después del final.
Los objetos Compare deben ser Swappable, y se intercambian usando una llamada no-calificada a una función no miembro swap.
|
Si |
(desde C++11) |
Parámetros
| other | - | El contenedor con el cual intercambiar el contenido. |
Valor de retorno
(Ninguno)
Excepciones
|
Cualquier excepción lanzada por el intercambio de los objetos |
(hasta C++17) | ||||||
|
Especificación noexcept: (desde C++11)
<tbody>
</tbody>
|
(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 (auto const& 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';
// Ten en cuenta que cada iterador que se refiere a un elemento en un contenedor
// antes del intercambio se refiere al mismo elemento en otro contenedor después
// del intercambio. Lo mismo es verdad 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';
// Así que los objetos comparadores (Cmp) también se intercambian después del intercambio.
}
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) |