std::array<T,N>:: swap
From cppreference.net
|
void
swap
(
array
&
other
)
noexcept
(
/* see below */
)
;
|
(начиная с C++11)
(constexpr начиная с C++20) |
|
Обменивает содержимое контейнера с содержимым other . Не приводит к тому, что итераторы и ссылки начинают ассоциироваться с другим контейнером.
Содержание |
Параметры
| other | - | контейнер для обмена содержимым |
Возвращаемое значение
(нет)
Исключения
|
noexcept
спецификация:
noexcept
(
noexcept
(
swap
(
std::
declval
<
T
&
>
(
)
,
std::
declval
<
T
&
>
(
)
)
)
)
В приведенном выше выражении идентификатор
|
(до C++17) |
|
noexcept
спецификация:
noexcept
(
std::
is_nothrow_swappable_v
<
T
>
)
|
(начиная с C++17) |
noexcept
спецификация:
noexcept
Сложность
Линейно по размеру контейнера.
Пример
Запустить этот код
#include <array> #include <iostream> template<class Os, class V> Os& operator<<(Os& os, const V& v) { os << '{'; for (auto i : v) os << ' ' << i; return os << " } "; } int main() { std::array<int, 3> a1{1, 2, 3}, a2{4, 5, 6}; auto it1 = a1.begin(); auto it2 = a2.begin(); int& ref1 = a1[1]; int& ref2 = a2[1]; std::cout << a1 << a2 << *it1 << ' ' << *it2 << ' ' << ref1 << ' ' << ref2 << '\n'; a1.swap(a2); std::cout << a1 << a2 << *it1 << ' ' << *it2 << ' ' << ref1 << ' ' << ref2 << '\n'; // Обратите внимание, что после swap итераторы и ссылки остаются связанными с их исходным // массивом, например `it1` всё ещё указывает на элемент a1[0], `ref1` всё ещё ссылается на a1[1]. }
Вывод:
{ 1 2 3 } { 4 5 6 } 1 4 2 5
{ 4 5 6 } { 1 2 3 } 4 1 5 2
Отчеты о дефектах
Следующие отчеты о дефектах, изменяющих поведение, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Применяется к | Поведение в опубликованной версии | Корректное поведение |
|---|---|---|---|
| LWG 2456 | C++11 |
спецификация
noexcept
некорректна
|
исправлено для работоспособности |
Смотрите также
|
(C++11)
|
специализирует алгоритм
std::swap
(шаблон функции) |