operator==, <=>(std::reference_wrapper)


friend constexpr bool
    operator==( reference_wrapper lhs, reference_wrapper rhs );
 (1) (C++26 起)
friend constexpr bool
    operator==( reference_wrapper lhs, reference_wrapper<const T> rhs );
 (2) (C++26 起)
friend constexpr bool
    operator==( reference_wrapper lhs, const T& ref );
 (3) (C++26 起)
friend constexpr auto
    operator<=>( reference_wrapper lhs, reference_wrapper rhs );
 (4) (C++26 起)
friend constexpr auto
    operator<=>( reference_wrapper lhs, reference_wrapper<const T> rhs );
 (5) (C++26 起)
friend constexpr auto
    operator<=>( reference_wrapper lhs, const T& ref );
 (6) (C++26 起)

实施 reference_wrapper 对象上的比较运算。

1,2) 比较两个 reference_wrapper 对象。当且仅当 lhs.get() 和 rhs.get() 相等时两对象比较相等。
  • 仅当表达式 lhs.get() == rhs.get() 良构且其结果可转换为 bool 时，这两个重载才参与重载决议。
  • 仅当 std::is_const_v<T> 为 false 时重载 (2) 才参与重载决议。
3) 比较 reference_wrapper 对象和一个引用。当且仅当 lhs.get() 等于 ref 时两形参比较相等。
  • 仅当表达式 lhs.get() == ref 良构且其结果能转换为 bool 时，重载 (3) 才参与重载决议。
4) 如同以 synth-three-way(lhs.get(), rhs.get()) 比较两个 reference_wrapper 对象。返回类型是 synth-three-way-result<T>。此重载只有在返回类型良构时才会参与重载决议。
5) 如同以 synth-three-way(lhs.get(), rhs.get()) 比较两个 reference_wrapper 对象。返回类型是 synth-three-way-result<T>。此重载只有在 std::is_const_v<T> 为 false 且返回类型良构时才会参与重载决议。
6) 如同以 synth-three-way(lhs.get(), ref) 比较 reference_wrapper 对象和一个引用。返回类型是 synth-three-way-result<T>。此重载只有在返回类型良构时才会参与重载决议。

<、<=、>、>= 及 != 运算符分别从 operator<=> 与 operator== 合成。

参数

lhs, rhs - 要比较的 reference_wrapper 对象
ref - 要与 reference_wrapper 对象比较的引用

返回值

1,2) lhs.get() == rhs.get()。
3) lhs.get() == ref。
4,5) synth-three-way(lhs.get(), rhs.get())。
6) synth-three-way(lhs.get(), ref)。

异常

抛出比较所抛出的异常。

注解

(4-6) 的返回类型是从 return 语句推导的，以避免实例化 std::reference_wrapper<T> 而 synth-three-way-result<T> 非良构时的硬错误。

功能特性测试宏 值 标准 功能特性
__cpp_lib_reference_wrapper 202403L (C++26) std::reference_wrapper 的比较

示例

本节未完成
原因：暂无示例