std::experimental::ranges::swap

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

技术规范

文件系统库 (文件系统 TS)

库基础 (库基础 TS)

库基础 2 (库基础 TS v2)

库基础 3 (库基础 TS v3)

并行扩展 (并行 TS)

并行扩展 2 (并行 TS v2)

并发扩展 (并发 TS)

并发扩展 2 (并发 TS v2)

概念 (概念 TS)

范围 (范围 TS)

反射 (反射 TS)

数学特殊函数 (特殊函数 TR)

 

范围

概念

通用工具

迭代器

范围

算法

 

通用工具库

工具组件
swap	exchange
函数对象
invoke identity	equal_to not_equal_to	greater less	greater_equal less_equal
元编程与类型特性
is_swappable_withis_swappable	is_nothrow_swappable_withis_nothrow_swappable	common_reference common_type
有标签的 pair 与 tuple
TagSpecifier TaggedType	tagged 标签说明符	tagged_pair make_tagged_pair	tagged_tuple make_tagged_tuple

 

在标头 <experimental/ranges/utility> 定义
namespace {     constexpr /* unspecified */ swap = /* unspecified */; }		(范围 TS) (定制点对象)
调用签名
template< class T, class U >     requires /* see below */ void swap(T&& t, U&& u) noexcept(/* 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 是满足 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 的函数调用运算符参与重载决议。

在每个定义 ranges::swap 的翻译单元中，它都指代定制点对象的同一实例。（这表示能自由地在类似 inline 函数和函数模板的东西中使用它，而不违反单一定义规则。）

异常

1)

noexcept 说明：  

noexcept(noexcept((void)swap(std::forward<T>(t), std::forward<T>(u))))

，其中按上述方式找到 swap 。

2)

noexcept 说明：  

noexcept(noexcept(ranges::swap(*t, *u)))

3)

noexcept 说明：  

noexcept(std::is_nothrow_move_constructible<V>::value &&
         std::is_nothrow_move_assignable<V>::value)

参阅

swap	交换两个对象的值 (函数模板)