std::swap(std::array)

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

コンテナライブラリ

シーケンス

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

deque

forward_list (C++11)

list

連想

set

multiset

map

multimap

非順序連想

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

アダプタ

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

表示

span (C++20)

mdspan (C++23)

表

イテレータの無効化

メンバ関数テーブル

非メンバ関数テーブル

 

std::array

メンバ型
メンバ関数
要素アクセス array::at array::operator[]    array::front array::back array::data 操作 array::fill array::swap	イテレータ array::beginarray::cbegin array::endarray::cend array::rbeginarray::crbegin    array::rendarray::crend	容量 array::empty array::size array::max_size
非メンバ関数
operator==operator<=> (C++20) get(std::array) swap(std::array) to_array (C++20)	operator|=operator<operator>operator<=operator>= (C++20まで)(C++20まで)(C++20まで)(C++20まで)(C++20まで)
ヘルパークラス
tuple_size<std::array>
tuple_element<std::array>
推論補助 (C++17)

 

ヘッダー <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(/* 以下を参照 */);		(C++17以降) (C++20 以降 constexpr)

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	内容を交換する (public メンバ関数)