std::experimental::ranges::adjacent_find

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏(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(并发 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	移除范围中连续的重复元素 (函数模板)