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

void swap( deque& other );		(до C++17)
void swap( deque& 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 <deque>
#include <print>

int main()
{
    std::deque<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::deque)

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

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