std::common_with (自 C++20 起)

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名需求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (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, class U > concept common_with =     std::same_as<std::common_type_t<T, U>, std::common_type_t<U, T>> &&     requires {         static_cast<std::common_type_t<T, U>>(std::declval<T>());         static_cast<std::common_type_t<T, U>>(std::declval<U>());     } &&     std::common_reference_with<         std::add_lvalue_reference_t<const T>,         std::add_lvalue_reference_t<const U>> &&     std::common_reference_with<         std::add_lvalue_reference_t<std::common_type_t<T, U>>,         std::common_reference_t<             std::add_lvalue_reference_t<const T>,             std::add_lvalue_reference_t<const U>>>;		(自 C++20 起)

概念 common_with<T, U> 指定两个类型 T 和 U 共享一个共同类型（由 std::common_type_t 计算），两者都可以转换为该类型。

语义要求

只有当给定 相等性保留 表达式 t1、t2、u1 和 u2，使得 decltype((t1)) 和 decltype((t2)) 均为 T，且 decltype((u1)) 和 decltype((u2)) 均为 U 时，T 和 U 才符合 std::common_with<T, U>。

• std::common_type_t<T, U>(t1) 等于 std::common_type_t<T, U>(t2) 当且仅当 t1 等于 t2；并且
• std::common_type_t<T, U>(u1) 等于 std::common_type_t<T, U>(u2) 当且仅当 u1 等于 u2。

换句话说，转换为共同类型必须 保留相等性。

相等性保留

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

参考资料

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

• 18.4.6 概念 common_with [concept.common]

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

• 18.4.6 概念 common_with [concept.common]

另请参阅

common_type (C++11)	确定一组类型的共同类型 (类模板)
common_referencebasic_common_reference (C++20)	确定一组类型的共同引用类型 (类模板)
common_reference_with (C++20)	指定两个类型共享一个共同引用类型 (概念)