std::is_swappable_with, std::is_swappable, std::is_nothrow_swappable_with, std::is_nothrow_swappable

来自cppreference.com
< cpp‎ | types
 
 
元编程库
类型特性
类型类别
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
类型属性
(C++11)
(C++11)
(C++14)
(C++11)
(C++11)(C++20 前)
(C++11)(C++20 中弃用)
(C++11)
类型特性常量
元函数
(C++17)
受支持操作
is_swappable_withis_swappableis_nothrow_swappable_withis_nothrow_swappable
(C++17)(C++17)(C++17)(C++17)

关系与属性查询
类型修改
(C++11)(C++11)(C++11)
类型变换
(C++11)
(C++11)
(C++17)
(C++11)(C++20 前)(C++17)
编译时有理数算术
编译时整数序列
 
在标头 <type_traits> 定义
template< class T, class U >
struct is_swappable_with;
(1) (C++17 起)
template< class T >
struct is_swappable;
(2) (C++17 起)
template< class T, class U >
struct is_nothrow_swappable_with;
(3) (C++17 起)
template< class T >
struct is_nothrow_swappable;
(4) (C++17 起)
1) 如果表达式 swap(std::declval<T>(), std::declval<U>())swap(std::declval<U>(), std::declval<T>()) 在使用 using std::swap; (见 可交换 (Swappable) )后的不求值语境中均为良构,那么成员常量 value 等于 true。对于其它类型,value 等于 false。如同从与任一类型皆无关的语境进行访问检查
2) 如果 T 不是可解引用类型(即可为 cv 限定的 void 或拥有 cv-qualifier-seqref-qualifier 的函数类型),则成员常量 value 等于 false。否则,等于 std::is_swappable_with<T&, T&>::value
3)(1) ,但已知来自 (1) 的两个表达式求值都不抛异常。
4)(2) ,但使用 is_nothrow_swappable_with

TU 都应该是完整类型、(可有 cv 限定的)void,或未知边界数组。否则行为未定义。

如果上述模板的实例化直接或间接地依赖于不完整类型,并且假设在该类型完整的情况下实例化就会产生不同的结果,那么行为未定义。

添加此页面上描述的任何模板的特化的程序行为未定义。

辅助变量模板

template <class T, class U>
inline constexpr bool is_swappable_with_v = is_swappable_with<T, U>::value;
(C++17 起)
template <class T>
inline constexpr bool is_swappable_v = is_swappable<T>::value;
(C++17 起)
template <class T, class U>
inline constexpr bool is_nothrow_swappable_with_v = is_nothrow_swappable_with<T, U>::value;
(C++17 起)
template <class T>
inline constexpr bool is_nothrow_swappable_v = is_nothrow_swappable<T>::value;
(C++17 起)

继承自 std::integral_constant

成员常量

value
[静态]
如果 T 可与 U 交换那么是 true,否则是 false
(公开静态成员常量)

成员函数

operator bool
将对象转换到 bool,返回 value
(公开成员函数)
operator()
(C++14)
返回 value
(公开成员函数)

成员类型

类型 定义
value_type bool
type std::integral_constant<bool, value>

注解

此特征不检查 swap 表达式的立即语境外的内容:如果 TU 的使用会触发模板特化,生成隐式定义的特定成员函数等,而它们有错误,那么即使 std::is_swappable_with<T,U>::value 通过编译且求值为 true ,实际的 swap 也可能无法编译。

示例

参阅

交换两个对象的值
(函数模板)
检查类型是否有拥有移动赋值运算符
(类模板)
指定一个类型能进行交换,或两个类型能彼此交换
(概念)