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 起)
(自 C++26 起为 constexpr) |
|
交换容器的内容与 other 的内容。不会对单个元素调用任何移动、复制或交换操作。
所有迭代器和引用保持有效。未指明在此容器中持有
end()
值的迭代器在操作后是否仍指向当前容器或另一个容器。
如果
std::
allocator_traits
<
allocator_type
>
::
propagate_on_container_swap
::
value
为
true
,则通过非限定调用非成员函数
swap
来交换分配器。否则,分配器不会被交换(且若
get_allocator
(
)
!
=
other.
get_allocator
(
)
,则行为未定义)。
目录 |
参数
| 其他 | - | 用于交换内容的容器 |
异常
|
(无) |
(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'; // 注意交换后迭代器和引用仍与其原始元素保持关联,例如 it1 原本指向 a1 中值为 2 的元素, // 交换后仍指向同一元素,尽管该元素已被移至 a2 中。 }
输出:
{ 1 2 3 } { 4 5 } 2 5 1 4
{ 4 5 } { 1 2 3 } 2 5 1 4
参见
|
(C++11)
|
特化
std::swap
算法
(函数模板) |