std::common_reference_with

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

输入/输出库

本地化库

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

原子操作库 (C++11)

线程支持库 (C++11)

文件系统库 (C++17)

技术规范

 

概念库

核心语言概念
same_as derived_from convertible_to common_reference_with common_with	integral signed_integral unsigned_integral floating_point swappableswappable_with	destructible constructible_from default_constructible move_constructible copy_constructible assignable_from
比较概念
boolean	equality_comparableequality_comparable_with	totally_orderedtotally_ordered_with
对象概念
movable copyable	semiregular regular
可调用概念
invocableregular_invocable	predicate	relation strict_weak_order

 

定义于头文件 <concepts>
template < class T, class U > concept common_reference_with =   std::same_as<std::common_reference_t<T, U>, std::common_reference_t<U, T>> &&   std::convertible_to<T, std::common_reference_t<T, U>> &&   std::convertible_to<U, std::common_reference_t<T, U>>;		(C++20 起)

概念 common_reference_with<T, U> 指定二个类型 T 与 U 共享均能转换到的共用引用类型（以 std::common_reference_t 计算）。

T 与 U 实现 common_reference_with<T, U> ，仅若给定保持相等性的表达式 t1 、 t2 、 u1 及 u2 ，且它们满足 decltype((t1)) 与 decltype((t2)) 均为 T 而 decltype((u1)) 与 decltype((u2)) 均为 U ，且

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

换言之，转换到共用引用类型必须保持相等性。

相等性保持

若表达式对给定的相等输入产生相等输出，则它保持相等性。

• 表达式的输入由其运算数组成。
• 表达式的输出由其结果和表达式所修改的所有运算数（若存在）组成。

进一步要求每个要求保持相等性的表达式都稳定：这种表达式带相同输入对象的二次求值必须拥有相等的输出，而无任何对这些输入对象的显式中间修改。

参阅

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