std::experimental::ranges::mismatch

 

C++

编译器支持

独立和宿主式

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

实验性

技术规范

文件系统库 (filesystem TS)

库基础 (library fundamentals TS)

库基础 2 (library fundamentals TS v2)

库基础 3 (library fundamentals TS v3)

并行扩展 (parallelism TS)

并行扩展 2 (parallelism TS v2)

并发扩展 (concurrency TS)

并发扩展 2 (concurrency TS v2)

概念 (concepts TS)

范围 (ranges TS)

反射 (reflection TS)

数学特殊函数 (special functions 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 Proj1 = ranges::identity, class Proj2 = ranges::identity,           class Pred = ranges::equal_to<> >     requires IndirectRelation<Pred, projected<I1, Proj1>, projected<I2, Proj2>> auto mismatch( I1 first1, S1 last1, I2 first2, S2 last2, Pred pred = Pred{},                Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{} )     -> ranges::tagged_pair<tag::in1(I1), tag::in2(I2)>;	(1)	(ranges TS)
template< InputRange R1, InputRange R2,           class Proj1 = ranges::identity, class Proj2 = ranges::identity,           class Pred = ranges::equal_to<> >     requires IndirectRelation<Pred, projected<ranges::iterator_t<R1>, Proj1>,                               projected<ranges::iterator_t<R2>, Proj2>> auto mismatch( R1&& r1, R2&& r2, Pred pred = Pred{},                Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{} )     -> ranges::tagged_pair<tag::in1(ranges::safe_iterator_t<R1>),                            tag::in2(ranges::safe_iterator_t<R2>)>;	(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> &&              IndirectRelation<Pred, projected<I1, Proj1>,                                     projected<std::decay_t<I2>, Proj2>> auto mismatch( I1 first1, S1 last1, I2&& first2_, Pred pred = Pred{},                Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{} )     -> ranges::tagged_pair<tag::in1(I1), tag::in2(std::decay_t<I2>)>;	(3)	(ranges TS) (deprecated)
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> &&              IndirectRelation<Pred, projected<ranges::iterator_t<R1>, Proj1>,                                     projected<std::decay_t<I2>, Proj2>> auto mismatch( R1&& r1, I2&& first2_, Pred pred = Pred{},                Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{} )     -> ranges::tagged_pair<tag::in1(ranges::safe_iterator_t<Rng1>),                            tag::in2(std::decay_t<I2>)>;	(4)	(ranges TS) (deprecated)

1) 返回来自两个范围的第一个不匹配的元素对：一个由 [first1, last1) 定义，另一个由 [first2, last2) 定义。

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

3) 与 (1) 相同，但行为如同 first2 为 std::decay_t<I2> first2 = std::forward<I2>(first2_); 且 last2 为 ranges::unreachable{}。底层算法永远不会将 first2 递增超过 last1 - first1 次。

4) 与 (3) 相同，但使用 r1 作为第一个源范围，如同使用 ranges::begin(r1) 作为 first1 和 ranges::end(r1) 作为 last1。

元素使用 pred 对两个范围的投影元素进行比较，如同通过 ranges::invoke(pred, ranges::invoke(proj1, *i), ranges::invoke(proj2, *j))。

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

参数

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

返回值

一个 tagged_pair 对象，包含指向前两个不相等元素的迭代器（来自第一个范围的迭代器带有标签 in1，来自第二个范围的迭代器带有标签 in2）。

如果在比较到达 last1 或 last2 时未找到不匹配项（以先到者为准），则该对保存结束迭代器以及来自另一个范围的相应迭代器。

复杂度

最多 last1 - first1 次谓词和每个投影的应用。

可能的实现

template<InputIterator I1, Sentinel<I1> S1, InputIterator I2, Sentinel<I2> S2, class Proj1 = ranges::identity, class Proj2 = ranges::identity, class Pred = ranges::equal_to<>> requires IndirectRelation<Pred, projected<I1, Proj1>, projected<I2, Proj2>> auto mismatch(I1 first1, S1 last1, I2 first2, S2 last2, Pred pred = Pred{}, Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{}) -> ranges::tagged_pair<tag::in1(I1), tag::in2(I2)> { while (first1 != last1 && first2 != last2 && ranges::invoke(pred, ranges::invoke(proj1, *first1), ranges::invoke(proj2, *first2))) { ++first1; ++first2; } return {first1, first2}; }

参见

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