std::ranges::swap
来自cppreference.com
| 定义于头文件 <concepts>
|
||
| inline namespace /* unspecified */ { inline constexpr /* unspecified */ swap = /* unspecified */; |
(C++20 起) (定制点对象) |
|
| 调用签名 |
||
| template< class T, class U > requires /* see below */ |
||
交换 t 和 u 所引用的值。
调用 ranges::swap 表达式等价于：
1) (void)swap(std::forward<T>(t), std::forward<U>(u)) ，若该表达式合法，其中以下列候选进行重载决议：
- template<class T> void swap(T&, T&) = delete;
- template<class T, std::size_t N> void swap(T(&)[N], T(&)[N]) = delete;
- 参数依赖查找所找到的任何
swap的声明。
若重载决议所选择的函数不交换
t 和 u 所引用的值，则程序为为病式；不要求诊断。2) 否则为 (void)ranges::swap_ranges(t, u) ，若
T 和 U 为到相等长度（但元素类型可能不同）的数组类型的左值引用，且 ranges::swap(*t, *u) 为合法表达式；3) 否则，若
T 与 U 均为 V& ，而 V 是满足 std::move_constructible<V> 和 std::assignable_from<V&, V> 要求的某个类型，则如同用 V v{std::move(t)}; t = std::move(u); u = std::move(v); 交换其被引用值。若任一概念的语义要求未得到满足，则程序为病式；不要求诊断。表达式等价
表达式 e 表达式等价于表达式 f ，若 e 与 f 拥有相同效果，均为潜在抛出或均非潜在抛出（即 noexcept(e) == noexcept(f) ），且均为常量子表达式或均非常量子表达式。
定制点对象
名字 ranges::swap 代表一个定制点对象，它是字面 semiregular 类类型（为说明目的以 swap_ftor 表示）的 const 函数对象。swap_ftor 的所有实例均相等。从而能自由地复制 ranges::swap ，且能交替使用其副本。
给定类型集合 Args... ，若 std::declval<Args>()... 满足上面对于 ranges::swap 的参数要求，则 swap_ftor 将满足 std::invocable<const swap_ftor&, Args...> 。否则， swap_ftor 的函数调用运算符不参与重载决议。
示例
| 本节未完成 原因：暂无示例 |
参阅
| (C++20) |
指定一个类型能进行交换，或两个类型能彼此交换 (概念) |
| 交换两个对象的值 (函数模板) |
