std::experimental::ranges::find_first_of

 

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< InputIterator I1, Sentinel<I1> S1, ForwardIterator I2, Sentinel<I2> S2,           class Proj1 =ranges::identity, class Proj2 =ranges::identity,           IndirectRelation<projected<I1, Proj1>,                            projected<I2, Proj2>> Pred =ranges::equal_to<>> I1 find_first_of( I1 first1, S1 last1, I2 first2, S2 last2, Pred pred = Pred{},                   Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{});	(1)	(范围 TS)
template< InputRange R1, ForwardRange R2,           class Proj1 =ranges::identity, class Proj2 =ranges::identity,           IndirectRelation<projected<ranges::iterator_t<R1>, Proj1>,                            projected<ranges::iterator_t<R2>, Proj2>> Pred =ranges::equal_to<>> ranges::safe_iterator_t<R1> find_first_of( R1&& r1, R2&& r2, Pred pred = Pred{},                                            Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{});	(2)	(范围 TS)

1) 在范围 [first1, last1) 中，经过以 proj1 和 proj2 分别投射两个范围后，搜索范围 [first2, last2) 中的任何元素。使用 pred 比较投射后的元素。

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

参数

first1, last1	-	要检验的元素范围
r1	-	要检验的元素范围
first2, last2	-	要搜索的元素范围
r2	-	要搜索的元素范围
pred	-	用于比较投射后元素的谓词
proj1	-	应用于第一范围中元素的投射
proj2	-	应用于第一范围中元素的投射

返回值

指向范围 [first1, last1) 中首个投射后等于范围 [first2, last2) 中元素的元素的迭代器。如果未找到这种元素，则返回与 last1 比较相等的迭代器。

复杂度

至多 (S * N) 此运用谓词和各投射，其中 S = distance(last2 - first2) 且 N = last1 - first1。

可能的实现

template<InputIterator I1, Sentinel<I1> S1, ForwardIterator I2, Sentinel<I2> S2, class Proj1 =ranges::identity, class Proj2 =ranges::identity, IndirectRelation<projected<I1, Proj1>, projected<I2, Proj2>> Pred =ranges::equal_to<>> I1 find_first_of(I1 first1, S1 last1, I2 first2, S2 last2, Pred pred = Pred{}, Proj1 proj1 = Proj1{}, Proj2 proj2 = Proj2{}){for(; first1 != last1;++first1)for(ForwardIt it = first2; it != last2;++it)if(ranges::invoke(pred, ranges::invoke(proj1, *first1), ranges::invoke(proj2, *it)))return first1;return first1;}

参阅

find_first_of	搜索一组元素中任一元素 (函数模板)
findfind_iffind_if_not	寻找首个满足特定判别标准的元素 (函数模板)