std::experimental::ranges::search_n

 

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 T,           class Pred =ranges::equal_to<>, class Proj =ranges::identity>     requires IndirectlyComparable<I, const T*, Pred, Proj> I search_n( I first, S last, ranges::difference_type_t<I> count,             const T& value, Pred pred = Pred{}, Proj proj = Proj{});	(1)	(范围 TS)
template< ForwardRange R, class T, class Pred =ranges::equal_to<>,           class Proj =ranges::identity>     requires IndirectlyComparable<ranges::iterator_t<R>, const T*, Pred, Proj> ranges::safe_iterator_t<R> search_n( R&& r,                                      ranges::difference_type_t<ranges::iterator_t<R>> count,                                      const T& value, Pred pred = Pred{}, Proj proj = Proj{});	(2)	(范围 TS)

1) 搜索范围 [first, last) 中首个 count 元素序列，其投射后的值根据谓词 pred 均等于给定值 value。

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

参数

first, last	-	要检验的元素范围
r	-	要检验的元素范围
count	-	要搜索的序列长度
value	-	要搜索的值
pred	-	比较投射后元素和 value 的谓词
proj	-	运用于元素的投射

返回值

指向范围 [first, last) 中找到的序列的开头的迭代器。如果未找到这种序列，则返回与 last 比较相等的迭代器。

复杂度

最多 last - first 此运用谓词和投射。

可能的实现

template<ForwardIterator I, Sentinel<I> S, class T, class Pred =ranges::equal_to<>, class Proj =ranges::identity> requires IndirectlyComparable<I, const T*, Pred, Proj> I search_n(I first, S last, ranges::difference_type_t<I> count, const T& value, Pred pred = Pred{}, Proj proj = Proj{}){for(; first != last;++first){if(!ranges::invoke(pred, ranges::invoke(proj, *first), value))continue;   I candidate = first; ranges::difference_type_t<I> cur_count =0;   while(true){++cur_count;if(cur_count == count)// successreturn candidate;   ++first;if(first == last)// exhausted the listreturn first;   if(!ranges::invoke(pred, ranges::invoke(proj, *first), value))// too few in a rowbreak;}}return first;}

参阅

search_n	搜索元素在范围中首次连续若干次出现 (函数模板)
find_end	在特定范围中寻找最后出现的元素序列 (函数模板)
findfind_iffind_if_not	寻找首个满足特定判别标准的元素 (函数模板)
search	搜索一个元素范围 (函数模板)