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)
(constexpr начиная с 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)

Пример

#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 << "\nBobby:";
    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 << "\nBobby:";
    std::for_each(bob.begin(), bob.end(), print);
    std::cout << '\n';
}

Вывод:

Alice: 1 2 3
Bobby: 7 8 9
-- SWAP
Alice: 7 8 9
Bobby: 1 2 3

См. также

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

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

Spec-Zone.ru

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