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

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

Обменивает содержимое и ёмкость контейнера с содержимым и ёмкостью 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>::propagate_on_container_swap::value or std::allocator_traits<Allocator>::is_always_equal::value)	(начиная с C++17)

Пример

#include <vector>
#include <print>

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

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.

DR	Применяется к	Опубликованное поведение	Корректное поведение
LWG 341	C++98	ёмкостями `std::vector` нельзя было обмениваться	они также обмениваются

См. также

std::swap(std::vector)

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

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