Spec-Zone.ru › C++

std::swap(std::array)

Определено в заголовке <array>
template< class T, std::size_t N >
void swap( std::array<T, N>& lhs,
           std::array<T, N>& rhs );
(с C++11)
(до C++17)
template< class T, std::size_t N >
void swap( std::array<T, N>& lhs,
           std::array<T, N>& rhs )
               noexcept(/* see below */);
(с C++17)
(до C++20)
template< class T, std::size_t N >
constexpr void swap( std::array<T, N>& lhs,
                     std::array<T, N>& rhs )
                         noexcept(/* see below */);
(с C++20)
Специализирует алгоритм std::swap для std::array. Обменивает содержимое lhs и rhs. Вызывает lhs.swap(rhs).

Этот перегруз участвует в разрешении перегрузки только если N == 0 или std::is_swappable_v<T> является true.

(с C++17)

Параметры

lhs, rhs - контейнеры, содержимое которых требуется обменять

Возвращаемое значение

(ничего)

Сложность

Линейна относительно размера контейнера.

Исключения

noexcept спецификация:
noexcept(noexcept(lhs.swap(rhs)))
(с C++17)

Примечания

Хотя перегрузки std::swap для адаптеров контейнеров введены в C++11, адаптеры контейнеров уже можно обменивать с помощью std::swap в C++98. Такие вызовы std::swap обычно имеют линейную сложность, но может быть обеспечена лучшая сложность.

Пример

#include <algorithm>
#include <iostream>
#include <array>
 
int main()
{
    std::array<int, 3> alice{1, 2, 3};
    std::array<int, 3> bob{7, 8, 9};
 
    auto print = [](const int& n) { std::cout << ' ' << n; };
 
    // Print state before swap
    std::cout << "alice:";
    std::for_each(alice.begin(), alice.end(), print);
    std::cout << "\n" "bob  :";
    std::for_each(bob.begin(), bob.end(), print);
    std::cout << '\n';
 
    std::cout << "-- SWAP\n";
    std::swap(alice, bob);
 
    // Print state after swap
    std::cout << "alice:";
    std::for_each(alice.begin(), alice.end(), print);
    std::cout << "\n" "bob  :";
    std::for_each(bob.begin(), bob.end(), print);
    std::cout << '\n';
}

Вывод:

alice: 1 2 3
bob  : 7 8 9
-- SWAP
alice: 7 8 9
bob  : 1 2 3

См. также

swap
обменивает содержимое
(публичный член-функция)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API