std::experimental::ranges::equal

 

C++

编译器支持

独立和宿主

语言

标准库

标准库头文件

命名需求

功能测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

实验性

技术规范

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

库基础 (库基础 TS)

库基础 2 (库基础 TS v2)

库基础 3 (库基础 TS v3)

并行扩展 (并行 TS)

并行扩展 2 (并行 TS v2)

并发扩展 (并发 TS)

并发扩展 2 (并发 TS v2)

概念 (概念 TS)

范围 (范围 TS)

反射 (反射 TS)

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

实验性非 TS

模式匹配

线性代数

std::execution

契约

2D 图形

 

范围

概念

通用实用程序

迭代器

范围

算法

 

算法库

非修改序列操作
all_ofany_ofnone_of countcount_if	findfind_iffind_if_not find_end find_first_of	adjacent_find search search_n mismatch	equal for_each lexicographical_compare
修改序列操作
copycopy_if copy_n copy_backward move move_backward	fill fill_n generate generate_n swap_ranges shuffle transform	removeremove_if replacereplace_if reverse rotate unique	remove_copyremove_copy_if replace_copyreplace_copy_if reverse_copy rotate_copy unique_copy
分区操作
is_partitioned partition_point	partition partition_copy	stable_partition
排序操作
is_sorted is_sorted_until	sort stable_sort	partial_sort partial_sort_copy	nth_element
二分搜索操作
lower_bound	upper_bound	binary_search	equal_range
集合操作（在排序范围上）
merge inplace_merge	includes	set_difference set_intersection	set_symmetric_difference set_union
堆操作
is_heap is_heap_until	make_heap sort_heap	push_heap pop_heap
最小/最大操作
max max_element	min min_element	minmax minmax_element
排列
is_permutation	next_permutation	prev_permutation

 

定义在头文件 <experimental/ranges/algorithm> 中
template< InputIterator I1, Sentinel<I1> S1, InputIterator I2, Sentinel<I2> S2,           class Pred = ranges::equal_to<>,           class Proj1 = ranges::identity, class Proj2 = ranges::identity >     requires IndirectlyComparable<I1, I2, Pred, Proj1, Proj2> bool equal( I1 first1, S1 last1, I2 first2, S2 last2, Pred pred = Pred{},             Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{} );	(1)	(范围 TS)
template< InputRange R1, InputRange R2, class Pred = ranges::equal_to<>,           class Proj1 = ranges::identity, class Proj2 = ranges::identity >     requires IndirectlyComparable<ranges::iterator_t<R1>, ranges::iterator_t<R2>,                                   Pred, Proj1, Proj2> bool equal( R1&& r1, R2&& r2, Pred pred = Pred{},             Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{} );	(2)	(范围 TS)
template< InputIterator I1, Sentinel<I1> S1, class I2,           class Pred = ranges::equal_to<>,           class Proj1 = ranges::identity, class Proj2 = ranges::identity >     requires InputIterator<std::decay_t<I2>> && !Range<I2> &&              IndirectlyComparable<I1, std::decay_t<I2>, Pred, Proj1, Proj2> bool equal( I1 first1, S1 last1, I2&& first2_, Pred pred = Pred{},             Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{} );	(3)	(范围 TS) (已弃用)
template< InputRange R1, class I2, class Pred = ranges::equal_to<>,           class Proj1 = ranges::identity, class Proj2 = ranges::identity >     requires InputIterator<std::decay_t<I2>> && !Range<I2> &&              IndirectlyComparable<ranges::iterator_t<R1>, std::decay_t<I2>, Pred, Proj1, Proj2> bool equal( R1&& r1, I2&& first2_, Pred pred = Pred{},             Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{} );	(4)	(范围 TS) (已弃用)

1) 如果范围 [first1, last1) 等于范围 [first2, last2)，则返回 true，否则返回 false。

2) 与 (1) 相同，但使用 r1 作为第一个源范围，r2 作为第二个源范围，就好像使用 ranges::begin(r1) 作为 first1，ranges::end(r1) 作为 last1，ranges::begin(r2) 作为 first2，ranges::end(r2) 作为 last2。

3) 与 (1) 相同，除了第二个范围被认为在第一个范围耗尽或检测到第一个不匹配时结束。等效于 return last1 == ranges::mismatch(first1, last1, std::forward<I2>(first2_), comp, proj1, proj2).in1();

4) 与 (3) 相同，但使用 r1 作为第一个源范围，就好像使用 ranges::begin(r1) 作为 first1 以及 ranges::end(r1) 作为 last1。

如果两个范围具有相同数量的元素，并且对于范围 `[`first1, last1) 中的每个迭代器 `i`，ranges::invoke(pred, ranges::invoke(proj1, *i), ranges::invoke(proj2, *(first2 + (i - first1)))) 为 true，则它们被认为是相等的。

尽管有上述声明，算法声明的模板参数的实际数量和顺序是未指定的。因此，如果在调用算法时使用显式模板参数，则程序可能不具有可移植性。

参数

first1, last1	-	元素的第一个范围
r1	-	元素的第一个范围
first2, last2	-	元素的第二个范围
r2	-	元素的第二个范围
first2_	-	元素的第二个范围的开始
pred	-	要应用于投影元素的谓词
proj1	-	要应用于第一个范围中元素的投影
proj2	-	要应用于第二个范围中元素的投影

返回值

如果两个范围相等，则返回 true，否则返回 false。

注释

ranges::equal 不应用于比较由来自 std::unordered_set、std::unordered_multiset、std::unordered_map 或 std::unordered_multimap 的迭代器形成的范围，因为即使两个容器存储相同的元素，元素存储的顺序也可能不同。

在比较整个容器是否相等时，通常首选对应容器的 `operator==`。

复杂度

1,2) 如果 SizedSentinel<S1, I1> && SizedSentinel<S2, I2> 满足且 last1 - first1 != last2 - first2，则谓词和投影不会应用。否则，谓词和每个投影最多应用 min(last1 - first1, last2 - first2) 次。

3,4) 谓词和每个投影最多应用 last1 - first1 次。

可能的实现

namespace detail { template<InputIterator I1, SizedSentinel<I1> S1, InputIterator I2, SizedSentinel<I1> S2> bool check_size(I1& first1, S1& last1, I2& first2, S2& last2) { return last1 - first1 != last2 - first2; }   template<InputIterator I1, Sentinel<I1> S1, InputIterator I2, Sentinel<I1> S2> bool check_size(I1& first1, S1& last1, I2& first2, S2& last2) { return false; } }   template<InputIterator I1, Sentinel<I1> S1, InputIterator I2, Sentinel<I2> S2, class Pred = ranges::equal_to<>, class Proj1 = ranges::identity, class Proj2 = ranges::identity> requires IndirectlyComparable<I1, I2, Pred, Proj1, Proj2> bool equal(I1 first1, S1 last1, I2 first2, S2 last2, Pred pred = Pred{}, Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{}) { if (detail::check_size(first1, last1, first2, last2)) return false; for (; first1 != last1 && first2 != last2; (void) ++first1, (void)++first2) if (!ranges::invoke(pred, ranges::invoke(proj1, *first1), ranges::invoke(proj2, *first2))) return false; return first1 == last1 && first2 == last2; }

另请参阅

equal	确定两组元素是否相同 (函数模板)
findfind_iffind_if_not	查找第一个满足特定条件的元素 (函数模板)
lexicographical_compare	如果一个范围在词典上小于另一个范围，则返回 true (函数模板)
mismatch	查找两个范围不同的第一个位置 (函数模板)
search	搜索一系列元素 (函数模板)