std::forward_list<T,Allocator>::swap

void swap( forward_list& other );		(начиная с C++11) (до C++17)
void swap( forward_list& other ) noexcept(/* see below */);			(начиная с C++17)

Обменивает содержимое контейнера с содержимым other. Не вызывает никаких операций перемещения, копирования или обмена для отдельных элементов.

Все итераторы и ссылки остаются действительными. Не указано, будет ли итератор, хранящий значение end() этого контейнера, после операции ссылаться на этот или другой контейнер.

Если std::allocator_traits<allocator_type>::propagate_on_container_swap::value равно true, аллокаторы обмениваются с помощью неквалифицированного вызова нешаблонной функции swap. В противном случае они не обмениваются (а если get_allocator() != other.get_allocator(), поведение не определено).

(начиная с C++11)

Параметры

other

контейнер, с которым обменивается содержимое

Сложность

Константная.

Исключения

(нет)	(до C++17)
`noexcept` спецификация: noexcept(std::allocator_traits<Allocator>::is_always_equal::value)	(начиная с C++17)

Пример

#include <forward_list>
#include <print>

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.begin();
    int& ref2 = *a2.begin();

    std::println("{} {} {} {} {} {}", a1, a2, *it1, *it2, ref1, ref2);
    a1.swap(a2);
    std::println("{} {} {} {} {} {}", a1, a2, *it1, *it2, ref1, ref2);

    // Note that after swap the iterators and references stay associated with their
    // original elements, e.g., it1 that pointed to an element in 'a1' with value 2
    // still points to the same element, though this element was moved into 'a2'.
}

Вывод:

[1, 2, 3] [4, 5] 2 5 1 4
[4, 5] [1, 2, 3] 2 5 1 4

См. также

std::swap(std::forward_list)

(C++11)

специализирует алгоритм std::swap
(шаблон функции)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/forward_list/swap