std::experimental::ranges::equal_to

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

技术规范

文件系统库 (文件系统 TS)

库基础 (库基础 TS)

库基础 2 (库基础 TS v2)

库基础 3 (库基础 TS v3)

并行扩展 (并行 TS)

并行扩展 2 (并行 TS v2)

并发扩展 (并发 TS)

并发扩展 2 (并发 TS v2)

概念 (概念 TS)

范围 (范围 TS)

反射 (反射 TS)

数学特殊函数 (特殊函数 TR)

 

范围

概念

通用工具

迭代器

范围

算法

 

通用工具库

工具组件
swap	exchange
函数对象
invoke identity	equal_to not_equal_to	greater less	greater_equal less_equal
元编程与类型特性
is_swappable_withis_swappable	is_nothrow_swappable_withis_nothrow_swappable	common_reference common_type
有标签的 pair 与 tuple
TagSpecifier TaggedType	tagged 标签说明符	tagged_pair make_tagged_pair	tagged_tuple make_tagged_tuple

 

定义于头文件 <experimental/ranges/functional>
template< class T = void >     requires ranges::EqualityComparable<T> ||              ranges::Same<T, void> ||              /* 二个 const T 左值上的 == 调用比较指针的内建运算符 */ struct equal_to;		(范围 TS)
template <> struct equal_to<void>;		(范围 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 ranges::EqualityComparableWith<T, U> ||              /* std::declval<T>() == std::declval<U>()                 解析成比较指针的内建运算符 */ constexpr bool operator()(T&& t, U&& u) const;	(2)	(仅为 equal_to<void> 特化的成员)

1) 比较 x 与 y 。等价于 return ranges::equal_to<>{}(x, y) ；

2) 比较 t 与 u ，等价于 return std::forward<T>(t) == std::forward<U>(u); ，除非表达式解析成调用比较指针的内建 operator == 。

当调用 (1) 或 (2) 会调用比较 P 类型指针的内建运算符时，替而以下列方式确定结果：

• 若（可能被转换的）第一参数值和（可能被转换的）第二参数值，在实现定义的、所有 P 类型指针值上的严格全序中，一者先于另一者，则返回 false 。此严格全序与内建运算符 < 、 > 、 <= 和 >= 所蕴含的偏序一致。
• 否则（无一先于另一者）返回 true 。

除非从 T 和 U 到 P 的转换序列均保持相等性（见后述），否则行为未定义。

相等性保持

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

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

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

注意

不同于 std::equal_to ， ranges::equal_to 要求 == 与 != 均合法（通过 EqualityComparable 和 EqualityComparableWith 制约）。

参阅

equal_to

实现 x == y 的函数对象 (类模板)