C++ 参考手册

位置：首页 > C++ 参考手册 >概念库 (C++20) > std::equality_comparable, std::equality_comparable_with

std::equality_comparable, std::equality_comparable_with

定义于头文件 <concepts>
template<class T, class U>

  concept __WeaklyEqualityComparableWith = // 仅为解释
    requires(const std::remove_reference_t<T>& t,
             const std::remove_reference_t<U>& u) {
      { t == u } -> std::boolean;
      { t != u } -> std::boolean;
      { u == t } -> std::boolean;
      { u != t } -> std::boolean;

    };
 (1)
template < class T >
concept equality_comparable = __WeaklyEqualityComparableWith<T, T>;
 (2) (C++20 起)
template <class T, class U>

concept equality_comparable_with =
  std::equality_comparable<T> &&
  std::equality_comparable<U> &&
  std::common_reference_with<
    const std::remove_reference_t<T>&,
    const std::remove_reference_t<U>&> &&
  std::equality_comparable<
    std::common_reference_t<
      const std::remove_reference_t<T>&,
      const std::remove_reference_t<U>&>> &&

  __WeaklyEqualityComparableWith<T, U>;
 (3) (C++20 起)
1) 仅为说明的概念 __WeaklyEqualityComparableWith<T, U> 指定 T 类型对象和 U 类型对象能用 == 和 != 彼此比较相等（以任一顺序），而比较结果一致。
2) 概念 equality_comparable<T> 指定比较运算符 == 和 != 在 T 上反映相等性： == 若且唯若运算数相等才生成 true 。
3) 概念 equality_comparable_with<T, U> 指定比较运算符 == 和 != 在（可能混合的） T 和 U 运算数上生成与相等一致的结果。比较混合的运算数产生的结果等价于比较转换到其共用类型的运算数。

语义要求

1) __WeaklyEqualityComparableWith<T, U> 仅若符合下列条件才得到实现。给定

下列为真：

  • t == u 、 u == t 、 t != u 、 u != t 拥有相同定义域；
  • bool(u == t) == bool(t == u) ；
  • bool(t != u) == !bool(t == u) ；且
  • bool(u != t) == bool(t != u) 。
2) equality_comparable<T> 仅若符合下列条件才得到实现。给定 T 类型对象 a 和 b ， bool(a == b) 若且唯若 a 和 b 相等才为 true 。同 a == b 保持相等性的要求，这隐含 == 为对称且传递，而且 == 进而对所有至少等于一个其他对象的 a 自反。
3) equality_comparable_with<T, U> 仅若符合下列条件才得到实现，给定任何 const std::remove_reference_t<T> 类型左值 t 和任何 const std::remove_reference_t<U> 类型左值 u ，并令 C 为 std::common_reference_t<const std::remove_reference_t<T>&, const std::remove_reference_t<U>&> ，则 bool(t == u) == bool(C(t) == C(u)) 。

相等性保持

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

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

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

除非另外提醒，每个用于 requires 表达式中的表达式都要求保持相等性且稳定，而表达式的求值必须只修改其非常运算数。必须不修改常运算数。

隐式表达式变种

使用不修改某 const 左值运算数的表达式的 requires 表达式亦隐式要求该表达式的额外变种对给定运算数接受非 const 左值或（可为 const 的）右值，除非以有区别的语义显式要求这种表达式变种。这些隐式表达式变种必须符合与声明的表达式的相同的语义。不指定实现以何种程度校验变种的语法。