std::experimental::ranges::find, std::experimental::ranges::find_if, std::experimental::ranges::find_if_not

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (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 图形

 

Ranges

概念

通用工具

迭代器

Ranges

算法

 

算法库

非修改序列操作
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
Permutations
is_permutation	next_permutation	prev_permutation

 

定义于头文件 <experimental/ranges/algorithm>
template< InputIterator I, Sentinel<I> S, class T, class Proj = ranges::identity >     requires IndirectRelation<ranges::equal_to<>, projected<I, Proj>, const T*> I find( I first, S last, const T& value, Proj proj = Proj{} );	(1)	(范围 TS)
template< InputRange R, class T, class Proj = ranges::identity >     requires IndirectRelation<ranges::equal_to<>,                               projected<ranges::iterator_t<R>, Proj>, const T*> ranges::safe_iterator_t<R> find( R&& r, const T& value, Proj proj = Proj{} );	(2)	(范围 TS)
template< InputIterator I, Sentinel<I> S, class Proj = ranges::identity,           IndirectUnaryPredicate<projected<I, Proj>> Pred > I find_if( I first, S last, Pred pred, Proj proj = Proj{} );	(3)	(范围 TS)
template< InputRange R, class Proj = ranges::identity,           IndirectUnaryPredicate<projected<ranges::iterator_t<R>, Proj>> Pred > ranges::safe_iterator_t<R> find_if( R&& r, Pred pred, Proj proj = Proj{} );	(4)	(范围 TS)
template< InputIterator I, Sentinel<I> S, class Proj = ranges::identity,           IndirectUnaryPredicate<projected<I, Proj>> Pred > I find_if_not( I first, S last, Pred pred, Proj proj = Proj{} );	(5)	(范围 TS)
template< InputRange R, class Proj = ranges::identity,           IndirectUnaryPredicate<projected<ranges::iterator_t<R>, Proj>> Pred > ranges::safe_iterator_t<R> find_if_not( R&& r, Pred pred, Proj proj = Proj{} );	(6)	(范围 TS)

返回范围 [first, last) 中满足特定条件的第一个元素

1) find 搜索其投影值等于 value 的元素（即 value == ranges::invoke(proj, *i)）。

3) find_if 搜索其投影值使谓词 p 返回 true 的元素（即 ranges::invoke(pred, ranges::invoke(proj, *i))) 为 true）。

5) find_if_not 搜索其投影值使谓词 q 返回 false 的元素（即 ranges::invoke(pred, ranges::invoke(proj, *i))) 为 false）。

2,4,6) 与 (1,3,5) 相同，但使用 r 作为源范围，如同使用 ranges::begin(r) 作为 first 和 ranges::end(r) 作为 last。

尽管上述声明所示，算法声明的实际模板参数数量和顺序未指定。因此，如果在调用算法时使用显式模板参数，程序可能不可移植。

参数

first, last	-	要检查的元素范围
r	-	要检查的元素范围
value	-	用于比较投影元素的值
pred	-	应用于投影元素的谓词
proj	-	应用于元素的投影

返回值

指向满足条件的第一个元素的迭代器。如果没有找到这样的元素，则返回一个与 last 比较相等的迭代器。

复杂度

谓词和投影至多应用 last - first 次。

可能实现

第一版
template<InputIterator I, Sentinel<I> S, class T, class Proj = ranges::identity> requires IndirectRelation<ranges::equal_to<>, projected<I, Proj>, const T*> I find(I first, S last, const T& value, Proj proj = Proj{}) { for (; first != last; ++first) if (ranges::invoke(proj, *first) == value) break; return first; }
第二版
template<InputIterator I, Sentinel<I> S, class Proj = ranges::identity, IndirectUnaryPredicate<projected<I, Proj>> Pred> I find_if(I first, S last, Pred pred, Proj proj = Proj{}) { for (; first != last; ++first) if (ranges::invoke(pred, ranges::invoke(proj, *first))) break; return first; }
第三版
template<InputIterator I, Sentinel<I> S, class Proj = ranges::identity, IndirectUnaryPredicate<projected<I, Proj>> Pred> I find_if_not(I first, S last, Pred pred, Proj proj = Proj{}) { for (; first != last; ++first) if (!ranges::invoke(pred, ranges::invoke(proj, *first))) break; return first; }

参阅

findfind_iffind_if_not (C++11)	寻找第一个满足特定条件的元素 (函数模板)
adjacent_find	寻找第一对相等的（或满足给定谓词的）相邻项 (函数模板)
find_end	在特定范围中寻找最后一次出现的元素序列 (函数模板)
find_first_of	搜索一组元素中的任何一个 (函数模板)
mismatch	寻找两个范围开始不同的第一个位置 (函数模板)
search	搜索元素范围 (函数模板)