CppDS.com

C++ 98 11 14 17 20 手册

std::ranges::swap

来自cppreference.com
< cpp‎ | utility
 
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)
swap 与类型运算
ranges::swap
(C++20)
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)

初等字符串转换
(C++17)
(C++17)
 
定义于头文件 <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 是满足 std::move_constructible<V>std::assignable_from<V&, V> 要求的某个类型,则如同用 V v{std::move(t)}; t = std::move(u); u = std::move(v); 交换其被引用值。若任一概念的语义要求未得到满足,则程序为病式;不要求诊断。
4) 所有其他情况下,对 ranges::swap 的调用为非良构,这能在 ranges::swap(t, u) 出现于模板实例化的立即语境时导致替换失败

表达式等价

表达式 e 表达式等价于表达式 f ,若 ef 拥有相同效果,均为潜在抛出或均非潜在抛出(即 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 的函数调用运算符不参与重载决议。

示例

参阅

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