std::swap

提供: cppreference.com

ヘッダ `<algorithm>` で定義		(C++11未満)
ヘッダ `<utility>` で定義		(C++11以上)
	(1)
template< class T > void swap( T& a, T& b );			(C++11未満)
template< class T > void swap( T& a, T& b ) noexcept(/* see below */);			(C++11以上) (C++20未満)
template< class T > constexpr void swap( T& a, T& b ) noexcept(/* see below */);			(C++20以上)
		(2)
template< class T2, std::size_t N > void swap( T2 (&a)[N], T2 (&b)[N]) noexcept(/* see below */);				(C++11以上) (C++20未満)
template< class T2, std::size_t N > constexpr void swap( T2 (&a)[N], T2 (&b)[N]) noexcept(/* see below */);				(C++20以上)

指定された値を入れ替えます。

1) 値 a と b を入れ替えます。このオーバーロードは std::is_move_constructible_v<T> && std::is_move_assignable_v<T> が true でなければオーバーロード解決に参加しません。 (C++17以上)

2) 配列 a と b を入れ替えます。実質的に std::swap_ranges(a, a+N, b) です。このオーバーロードは std::is_swappable_v<T2> が true でなければオーバーロード解決に参加しません。 (C++17以上)

`noexcept` 指定: noexcept(noexcept(swap(a, b))) 例外仕様の中の識別子 `swap` の名前探索は、通常の名前探索ルールによって発見されるものに加えて、この関数が発見されます。 C++17 の std::is_nothrow_swappable と同等の例外仕様になります。	(C++17未満)
`noexcept` 指定: noexcept(std::is_nothrow_swappable_v<T2>)	(C++17以上)

[編集] 計算量

1) 定数時間

2) N の線形時間

[編集] 特殊化

std::swap はプログラム定義型に対して std 名前空間内で特殊化しても構いません。しかしそのような特殊化は ADL で発見されません (std 名前空間はプログラム定義型に対して関連付けれらた名前空間ではありません)。

(C++20未満)

プログラム定義型を swap 可能にする期待されている方法は、その型と同じ名前空間で非メンバ関数 swap を提供することです。詳細は Swappable を参照してください。

以下のオーバーロードが標準ライブラリによってすでに提供されています。

std::swap(std::pair) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::tuple) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::shared_ptr) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::weak_ptr) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::unique_ptr) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::function) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::basic_string)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::array) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::deque)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::forward_list) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::list)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::vector)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::map)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::multimap)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::set)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::multiset)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::unordered_map) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::unordered_multimap) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::unordered_set) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::unordered_multiset) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::queue)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::priority_queue)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::stack)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::valarray) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::basic_stringbuf) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::basic_istringstream) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::basic_ostringstream) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::basic_stringstream) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::basic_filebuf) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::basic_ifstream) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::basic_ofstream) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::basic_fstream) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::basic_syncbuf) (C++20)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::basic_regex) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::match_results) (C++11)	`std::swap` アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::thread) (C++11)	std::swap ア��ゴリズムの特殊化 (関数) [edit]
std::swap(std::unique_lock) (C++11)	`unique_lock` に対する std::swap の特殊化 (関数テンプレート) [edit]
std::swap(std::promise) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::packaged_task) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート) [edit]
std::swap(std::optional) (C++17)	std::swap アルゴリズムの特殊化 (関数) [edit]
std::swap(std::any) (C++17)	std::swap アルゴリズムの特殊化 (関数) [edit]
std::swap(std::variant) (C++17)	std::swap アルゴリズムの特殊化 (関数) [edit]
swap(std::filesystem::path)	2つのパスを入れ替えます (関数) [edit]

[編集] 例

Run this code

#include <algorithm>
#include <iostream>
 
int main()
{
   int a = 5, b = 3;
 
   // before
   std::cout << a << ' ' << b << '\n';
 
   std::swap(a,b);
 
   // after
   std::cout << a << ' ' << b << '\n';
}

出力:

5 3
3 5

[編集] 不具合報告

以下の動作変更欠陥報告は以前に発行された C++ 標準に遡って適用されました。

DR	適用先	発行時の動作	正しい動作
LWG 2554	C++11	swapping multi-dimensional arrays can never be `noexcept` due to name lookup problems	made to work

[編集] 関連項目

iter_swap	2つのイテレータが指す要素を入れ替えます (関数テンプレート) [edit]
swap_ranges	2つの範囲の要素を入れ替えます (関数テンプレート) [edit]
exchange (C++14)	引数を新しい値で置き換え、その以前の値を返します (関数テンプレート) [edit]

「https://ja.cppreference.com/mwiki/index.php?title=cpp/algorithm/swap&oldid=47000」から取得

カテゴリ:

conditionally noexcept

言語
標準ライブラリヘッダ
フリースタンディング処理系とホスト処理系
名前付き要件
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
ユーティリティライブラリ
文字列ライブラリ
コンテナライブラリ
イテレータライブラリ
範囲ライブラリ (C++20)
アルゴリズムライブラリ
数値演算ライブラリ
ローカライゼーションライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
正規表現ライブラリ (C++11)
アトミック操作ライブラリ (C++11)
スレッドサポートライブラリ (C++11)
技術仕様書

a, b	-	入れ替えられる値
型の要件
- `T` は MoveAssignable および MoveConstructible の要件を満たさなければなりません。
- `T2` は Swappable の要件を満たさなければなりません。

cppreference.com

名前空間

変種

表示

操作

std::swap

目次

[編集] 引数

[編集] 戻り値

[編集] 例外

[編集] 計算量

[編集] 特殊化

[編集] 例

[編集] 不具合報告

[編集] 関連項目

案内

ツールボックス

(なし)	(C++11未満)
`noexcept` 指定: noexcept( std::is_nothrow_move_constructible<T>::value && std::is_nothrow_move_assignable<T>::value )	(C++11以上)