std::swappable, std::swappable_with

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

概念库

核心语言概念 same_as (C++20) derived_from (C++20) convertible_to (C++20) common_reference_with (C++20) common_with (C++20) integral (C++20) signed_integral (C++20) unsigned_integral (C++20) floating_point (C++20) swappableswappable_with (C++20)(C++20) destructible (C++20) constructible_from (C++20) default_initializable (C++20)   move_constructible (C++20) copy_constructible (C++20) assignable_from (C++20)

比较概念 equality_comparableequality_comparable_with (C++20)(C++20) totally_orderedtotally_ordered_with (C++20)(C++20) 对象概念 movable (C++20) copyable (C++20) semiregular (C++20) regular (C++20) 可调用概念 invocableregular_invocable (C++20)(C++20) predicate (C++20) relation (C++20) equivalence_relation (C++20) strict_weak_order (C++20)

仅用于阐释的概念 boolean-testable  (C++20)

 

定义于头文件 <concepts>
template< class T > concept swappable =     requires(T& a, T& b) {         ranges::swap(a, b);     };	(1)	(C++20 起)
template< class T, class U > concept swappable_with =     std::common_reference_with<T, U> &&     requires(T&& t, U&& u) {         ranges::swap(std::forward<T>(t), std::forward<T>(t));         ranges::swap(std::forward<U>(u), std::forward<U>(u));         ranges::swap(std::forward<T>(t), std::forward<U>(u));         ranges::swap(std::forward<U>(u), std::forward<T>(t));     };	(2)	(C++20 起)

概念 swappable<T> 指定类型 T 的左值是可交换的。

概念 swappable_with<T, U> 指定由 T 和 U 编码的类型和值类别的表达式可以相互交换。当且仅当对 ranges::swap(t, u) 的调用交换了 t 和 u 的值时，swappable_with<T, U> 才被满足，也就是说，给定与 t 相等的不同对象 t2 和与 u 相等的 u2，在计算 ranges::swap(t, u) 或 ranges::swap(u, t) 之后，t2 等于 u 且 u2 等于 t。

等价性保留

标准库概念的 requires 表达式中声明的表达式必须是等价性保留的（除非另有说明）。

参考

• C++23 标准 (ISO/IEC 14882:2024)

• 18.4.9 概念 swappable [concept.swappable]

• C++20 标准 (ISO/IEC 14882:2020)

• 18.4.9 概念 swappable [concept.swappable]