std::ranges::swap

来自cppreference.com
< cpp‎ | utility
定义于头文件 <concepts>
inline namespace /* unspecified */ {

    inline constexpr /* unspecified */ swap = /* unspecified */;

}
(C++20 起)
(定制点对象)
调用签名
template< class T, class U >

    requires /* see below */

constexpr void swap(T&& t, U&& u) noexcept(/* see below */);

交换 tu 所引用的值。

调用 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 的声明。
若重载决议所选择的函数不交换 tu 所引用的值,则程序为为病式;不要求诊断。
2) 否则为 (void)ranges::swap_ranges(t, u) ,若 TU 为到相等长度(但元素类型可能不同)的数组类型的左值引用,且 ranges::swap(*t, *u) 为合法表达式;
3) 否则,若 TU 均为 V& ,而 V 是满足 ranges::MoveConstructible<V>ranges::Assignable<V&, V> 要求的某个类型,则如同用 V v{std::move(t)}; t = std::move(u); u = std::move(v); 交换其被引用值。若任一概念的语义要求未得到满足,则程序为病式;不要求诊断。
4) 所有其他情况下,对 ranges::swap 的调用为病式。

ranges::swap 调用的每个函数(按上述方式指定)都能用于常量表达式中,则亦能如此使用它。

目录

[编辑] 定制点对象

名称 ranges::swap 代表一个定制点对象,它是字面 Semiregular 类类型的函数对象(为说明目的以 SwapT 表示)。SwapT 的所有实例均相等。从而能自由地复制 ranges::swap ,且能交替使用其副本。

给定类型集合 Args... ,若 std::declval<Args>()... 满足上面对于 ranges::swap 的参数要求,则 SwapT 将满足 ranges::Invocable<const SwapT&, Args...> 。否则, SwapT 的函数调用运算符不会参与重载决议。

[编辑] 异常

1)
noexcept 规定:  
noexcept(noexcept((void)swap(std::forward<T>(t), std::forward<T>(u))))
,其中按上述方式找到 swap
2)
noexcept 规定:  
noexcept(noexcept(ranges::swap(*t, *u)))
3)

[编辑] 示例

[编辑] 参阅

指定一个类型能进行交换,或两个类型能彼此交换
(概念) [编辑]
交换两个对象的值
(函数模板) [编辑]