std::forward_list<T,Allocator>:: swap
|
void
swap
(
forward_list
&
other
)
;
|
(C++11以降)
(C++17まで) |
|
|
void
swap
(
forward_list
&
other
)
noexcept
(
/* see below */
)
;
|
(C++17以降)
(constexprはC++26以降) |
|
コンテナの内容を other の内容と交換します。個々の要素に対するムーブ、コピー、スワップ操作は一切呼び出しません。
すべてのイテレータと参照は有効なままです。このコンテナ内の
end()
値を保持するイテレータが、操作後にこのコンテナまたは他のコンテナを参照するかどうかは未規定です。
std::
allocator_traits
<
allocator_type
>
::
propagate_on_container_swap
::
value
が
true
の場合、アロケータは非メンバ関数
swap
の非修飾呼び出しを使用して交換されます。そうでない場合、それらは交換されません(また
get_allocator
(
)
!
=
other.
get_allocator
(
)
の場合、動作は未定義です)。
目次 |
パラメータ
| other | - | 内容を交換するコンテナ |
例外
|
(なし) |
(C++17まで) |
|
noexcept
指定:
noexcept
(
std::
allocator_traits
<
Allocator
>
::
is_always_equal
::
value
)
|
(C++17以降) |
計算量
定数。
例
#include <iostream> #include <forward_list> template<class Os, class Co> Os& operator<<(Os& os, const Co& co) { os << '{'; for (const auto& i : co) os << ' ' << i; return os << " } "; } int main() { std::forward_list<int> a1{1, 2, 3}, a2{4, 5}; auto it1 = std::next(a1.begin()); auto it2 = std::next(a2.begin()); int& ref1 = a1.front(); int& ref2 = a2.front(); std::cout << a1 << a2 << *it1 << ' ' << *it2 << ' ' << ref1 << ' ' << ref2 << '\n'; a1.swap(a2); std::cout << a1 << a2 << *it1 << ' ' << *it2 << ' ' << ref1 << ' ' << ref2 << '\n'; // swap後もイテレータと参照は元の要素に関連付けられたままであることに注意 // 例えば、値2の'a1'内の要素を指していたit1は、この要素が'a2'に移動した後も // 同じ要素を指し続ける }
出力:
{ 1 2 3 } { 4 5 } 2 5 1 4
{ 4 5 } { 1 2 3 } 2 5 1 4
関連項目
|
(C++11)
|
std::swap
アルゴリズムを特殊化する
(関数テンプレート) |