std::forward_list<T,Allocator>:: swap
|
void
swap
(
forward_list
&
other
)
;
|
(desde C++11)
(hasta C++17) |
|
|
void
swap
(
forward_list
&
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. No está especificado si un iterador que contiene el valor
end()
en este contenedor hará referencia a este o al otro contenedor después de la operación.
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
swap
. De lo contrario, no se intercambian (y si
get_allocator
(
)
!
=
other.
get_allocator
(
)
, el comportamiento es indefinido).
Contenidos |
Parámetros
| otro | - | contenedor con el cual intercambiar los contenidos |
Excepciones
|
(ninguno) |
(hasta C++17) |
|
noexcept
especificación:
noexcept
(
std::
allocator_traits
<
Allocator
>
::
is_always_equal
::
value
)
|
(desde C++17) |
Complejidad
Constante.
Ejemplo
#include <iostream> #include <forward_list> 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::forward_list<int> a1{1, 2, 3}, a2{4, 5}; auto it1 = std::next(a1.begin()); auto it2 = std::next(a2.begin()); int& ref1 = a1.front(); int& ref2 = a2.front(); std::cout << a1 << a2 << *it1 << ' ' << *it2 << ' ' << ref1 << ' ' << ref2 << '\n'; a1.swap(a2); std::cout << a1 << a2 << *it1 << ' ' << *it2 << ' ' << ref1 << ' ' << ref2 << '\n'; // Nótese que después del intercambio los iteradores y referencias permanecen asociados con sus // elementos originales, p.ej. it1 que apuntaba a un elemento en 'a1' con valor 2 // sigue apuntando al mismo elemento, aunque este elemento fue movido a 'a2'. }
Salida:
{ 1 2 3 } { 4 5 } 2 5 1 4
{ 4 5 } { 1 2 3 } 2 5 1 4
Véase también
|
(C++11)
|
especializa el algoritmo
std::swap
(plantilla de función) |