std::experimental::ranges::adjacent_find

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

技术规范

符号索引

外部库

 

实验性

技术规范

文件系统库 (文件系统 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< ForwardIterator I, Sentinel<I> S, class Proj = ranges::identity,           IndirectRelation<projected<I, Proj>> Pred = ranges::equal_to<> > I adjacent_find( I first, S last, Pred pred = Pred{}, Proj proj = Proj{} );	(1)	(范围 TS)
template< ForwardRange R, class Proj = ranges::identity,           IndirectRelation<projected<ranges::iterator_t<R>, Proj>> Pred = ranges::equal_to<> > ranges::safe_iterator_t<R> adjacent_find( R&& r, Pred pred = Pred{}, Proj proj = Proj{} );	(2)	(范围 TS)

1) 在范围 [first, last) 中搜索两个连续的相同元素。在以 proj 投射后使用 pred 来比较元素。

2) 与 (1) 相同，但使用 r 为源范围，如同以 ranges::begin(r) 为 first 并以 ranges::end(r) 为 last。

尽管声明描述如上，算法声明的模板形参的实际数量和顺序是未指定的。从而若在调用算法时使用显式模板实参，则程序很可能不可移植。

参数

first, last	-	要检验的元素范围
r	-	要检验的元素范围
pred	-	用于比较投射后元素的谓词
proj	-	运用于元素的投射

返回值

指向第一对相同元素中前者的迭代器，即首个使得 i 和 i + 1 均在范围 [first, last) 中且 ranges::invoke(pred, ranges::invoke(proj, *i), ranges::invoke(proj, *(i + 1))) != false 的迭代器 i。

如果未找到这种元素，则返回与 last 比较相等的迭代器。

复杂度

如果范围非空，则刚好 min((result - first) + 1, (last - first) - 1) 次运用谓词，其中 result 为返回值，且至多两倍次数运用投射。

可能的实现

template<ForwardIterator I, Sentinel<I> S, class Proj = ranges::identity, IndirectRelation<projected<I, Proj>> Pred = ranges::equal_to<>> I adjacent_find(I first, S last, Pred pred = Pred{}, Proj proj = Proj{}) { if (first == last) return first; I next = first; ++next; while (next != last) { if (ranges::invoke(pred, ranges::invoke(proj, *first), ranges::invoke(proj, *next))) return first; ++next; ++first; } return next; }

参阅

adjacent_find	查找首对相邻的相同（或满足给定谓词的）元素 (函数模板)
unique	移除范围中连续的重复元素 (函数模板)