std::experimental::ranges::search_n

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (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

契约

二维图形

 

范围

概念

通用实用程序

迭代器

范围

算法

 

算法库

非修改序列操作
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) // success return candidate;   ++first; if (first == last) // exhausted the list return first;   if (!ranges::invoke(pred, ranges::invoke(proj, *first), value)) // too few in a row break; } } return first; }

另请参阅

search_n	搜索范围内某个元素的连续副本的第一次出现 (函数模板)
find_end	查找某个范围内的最后一个元素序列 (函数模板)
findfind_iffind_if_not	查找第一个满足特定条件的元素 (函数模板)
search	搜索一个元素范围 (函数模板)