std::experimental::ranges::equal

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

實驗性

技術規範

檔案系統庫 (檔案系統 TS)

庫基礎 (庫基礎 TS)

庫基礎 2 (庫基礎 TS v2)

庫基礎 3 (庫基礎 TS v3)

並行性擴充套件 (並行性 TS)

並行性擴充套件 2 (並行性 TS v2)

併發性擴充套件 (併發性 TS)

併發擴充套件 2 (concurrency TS v2)

概念 (概念 TS)

範圍 (範圍 TS)

反射 (反射 TS)

數學特殊函式 (特殊函式 TR)

實驗性非 TS

模式匹配

線性代數

std::execution

契約

2D 圖形

 

Ranges

概念

通用工具

迭代器

Ranges

演算法

 

演算法庫

非修改序列操作
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
Permutations
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)	(Ranges 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)	(Ranges 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)	(Ranges 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)	(Ranges 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	搜尋元素範圍 (函式模板)