命名空间
变体
操作

std::experimental::ranges::equal_to

来自 cppreference.cn
< cpp‎ | experimental‎ | ranges
 
 
实验性
技术规范
文件系统库 (文件系统 TS)
库基础 (库基础 TS)
库基础 2 (库基础 TS v2)
库基础 3 (库基础 TS v3)
并行性扩展 (并行性 TS)
并行性扩展 2 (并行性 TS v2)
并发性扩展 (并发性 TS)
并发扩展 2 (并发 TS v2)
概念 (概念 TS)
范围 (范围 TS)
反射 (反射 TS)
数学特殊函数 (特殊函数 TR)
实验性非 TS
模式匹配
线性代数
std::execution
契约
2D 图形
 
 
通用工具库
实用组件
函数对象
equal_to
元编程和类型特征
带标签的对和元组
                          
tag specifiers
                                      
                          
 
template< class T = void >

    requires EqualityComparable<T> ||
             Same<T, void> ||
             /* 对两个 const T 左值调用内置的指针比较运算符 */

struct equal_to;
(ranges TS)
template<>
struct equal_to<void>;
(ranges TS)

用于执行比较的函数对象。主模板在类型为 T 的 const 左值上调用 operator ==。特化 equal_to<void> 从参数推导函数调用运算符的参数类型(但不是返回类型)。

所有 equal_to 的特化都是 Semiregular

目录

[编辑] 成员类型

成员类型 定义
is_transparent (仅属于 equal_to<void> 特化成员) /* 未指定 */

[编辑] 成员函数

operator()
检查参数是否“相等”
(公开成员函数)

std::experimental::ranges::equal_to::operator()

constexpr bool operator()(const T& x, const T& y) const;
(1) (仅属于主 equal_to<T> 模板成员)
template< class T, class U >

    requires EqualityComparableWith<T, U> ||
             /* std::declval<T>() == std::declval<U>() 解析为 */
                内置的指针比较操作符 */

constexpr bool operator()(T&& t, U&& u) const;
(2) (仅属于 equal_to<void> 特化成员)
1) 比较 xy。等价于 return ranges::equal_to<>{}(x, y);
2) 比较 tu。等价于 return std::forward<T>(t) == std::forward<U>(u);,除非该表达式解析为调用比较指针的内置 operator ==

当调用 (1)(2) 将调用比较类型 P 的指针的内置运算符时,结果将按以下方式确定:

  • 如果第一个参数的(可能已转换的)值和第二个参数的(可能已转换的)值之一在类型 P 的所有指针值的实现定义的严格全序中位于另一个之前,则返回 false。此严格全序与内置运算符 <><=>= 施加的偏序一致。
  • 否则(两者均未位于另一个之前),返回 true

除非从 TUP 的转换序列都是相等性保持的(见下文),否则行为是未定义的。

[编辑] 相等性保持

如果一个表达式在给定相等输入时产生相等输出,则称其为保持相等性

  • 表达式的输入由其操作数组成。
  • 表达式的输出由其结果以及被表达式修改的所有操作数(如果有的话)组成。

所有要求保持相等性的表达式还必须是稳定的:在没有显式介入修改输入对象的情况下,对具有相同输入对象的表达式的两次求值必须产生相等的输出。

[编辑] 注意

std::equal_to 不同,ranges::equal_to 要求 ==!= 均有效(通过 EqualityComparableEqualityComparableWith 约束)。

[编辑] 示例

[编辑] 另见

实现 x == y 的函数对象
(类模板) [编辑]