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

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

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

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

技术规范

符号索引

外部库

 

元编程库

类型特性
类型类别 is_void (C++11) is_null_pointer (C++14) is_array (C++11) is_pointer (C++11) is_enum (C++11) is_union (C++11) is_class (C++11) is_function (C++11) is_object (C++11) is_scalar (C++11) is_compound (C++11) is_integral (C++11) is_floating_point (C++11) is_fundamental (C++11) is_arithmetic (C++11) is_reference (C++11) is_lvalue_reference (C++11) is_rvalue_reference (C++11) is_member_pointer (C++11) is_member_object_pointer (C++11) is_member_function_pointer (C++11) 类型属性 is_const (C++11) is_volatile (C++11) is_empty (C++11) is_polymorphic (C++11) is_final (C++14) is_abstract (C++11) is_aggregate (C++17) is_trivial (C++11) is_trivially_copyable (C++11) is_standard_layout (C++11) is_literal_type (C++11)(C++20 前) is_pod (C++11)(C++20 中弃用) is_signed (C++11) is_unsigned (C++11) is_bounded_array (C++20) is_unbounded_array (C++20) is_scoped_enum (C++23) has_unique_object_representations (C++17) 类型特性常量 integral_constantbool_constanttrue_typefalse_type (C++11)(C++17)(C++11)(C++11) 元函数 conjunction (C++17) disjunction (C++17) negation (C++17)	受支持操作 is_constructibleis_trivially_constructibleis_nothrow_constructible (C++11)(C++11)(C++11) is_default_constructibleis_trivially_default_constructibleis_nothrow_default_constructible (C++11)(C++11)(C++11) is_copy_constructibleis_trivially_copy_constructibleis_nothrow_copy_constructible (C++11)(C++11)(C++11) is_move_constructibleis_trivially_move_constructibleis_nothrow_move_constructible (C++11)(C++11)(C++11) is_assignableis_trivially_assignableis_nothrow_assignable (C++11)(C++11)(C++11) is_copy_assignableis_trivially_copy_assignableis_nothrow_copy_assignable (C++11)(C++11)(C++11) is_move_assignableis_trivially_move_assignableis_nothrow_move_assignable (C++11)(C++11)(C++11) is_destructibleis_trivially_destructibleis_nothrow_destructible (C++11)(C++11)(C++11) has_virtual_destructor (C++11) is_swappable_withis_swappableis_nothrow_swappable_withis_nothrow_swappable (C++17)(C++17)(C++17)(C++17) 关系与属性查询 is_same (C++11) is_base_of (C++11) is_convertibleis_nothrow_convertible (C++11)(C++20) is_layout_compatible (C++20) is_pointer_interconvertible_base_of (C++20) is_pointer_interconvertible_with_class (C++20) is_corresponding_member (C++20) alignment_of (C++11) rank (C++11) extent (C++11) is_invocableis_invocable_ris_nothrow_invocableis_nothrow_invocable_r (C++17)(C++17)(C++17)(C++17) 类型修改 remove_cvremove_constremove_volatile (C++11)(C++11)(C++11) add_cvadd_constadd_volatile (C++11)(C++11)(C++11) make_signed (C++11) make_unsigned (C++11) remove_reference (C++11) add_lvalue_referenceadd_rvalue_reference (C++11)(C++11) remove_pointer (C++11) add_pointer (C++11) remove_extent (C++11) remove_all_extents (C++11) 类型变换 aligned_storage (C++11) aligned_union (C++11) decay (C++11) remove_cvref (C++20) enable_if (C++11) void_t (C++17) conditional (C++11) common_type (C++11) common_reference (C++20) underlying_type (C++11) result_ofinvoke_result (C++11)(C++20 前)(C++17) type_identity (C++20)
编译时有理数算术
编译时整数序列
integer_sequence (C++14)

 

在标头 <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-seq 或 ref-qualifier 的函数类型），则成员常量 value 等于 false。否则，等于 std::is_swappable_with<T&, T&>::value。

3) 同 (1) ，但已知来自 (1) 的两个表达式求值都不抛异常。

4) 同 (2) ，但使用 is_nothrow_swappable_with 。

T 与 U 都应该是完整类型、（可有 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 表达式的立即语境外的内容：如果 T 或 U 的使用会触发模板特化，生成隐式定义的特定成员函数等，而它们有错误，那么即使 std::is_swappable_with<T,U>::value 通过编译且求值为 true ，实际的 swap 也可能无法编译。

参阅

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