std::common_reference_with

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

概念库

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

比较概念 equality_comparableequality_comparable_with totally_orderedtotally_ordered_with 对象概念 movable copyable semiregular regular 可调用概念 invocableregular_invocable predicate relation equivalence_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 。

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

相等性保持

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

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

在标准概念的规范中，操作数定义为仅包含下列内容的最大子表达式：

• 标识表达式，及
• 对 std::move 、 std::forward 与 std::declval 的调用。

每个操作数的 cv 限定与值类别，是通过假设每个模板类型形参代表一个 cv 无限定的非数组对象类型确定的。

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

参阅

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