std::experimental::ranges::for_each

 

C++

编译器支持

独立式和宿主式

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

实验性

技术规范

文件系统库 (filesystem TS)

库基础 (library fundamentals TS)

库基础 2 (library fundamentals TS v2)

库基础 3 (library fundamentals TS v3)

并行扩展 (parallelism TS)

并行扩展 2 (parallelism TS v2)

并发扩展 (concurrency TS)

并发扩展 2 (concurrency TS v2)

概念 (concepts TS)

范围 (ranges TS)

反射 (reflection TS)

数学特殊函数 (special functions 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 I, Sentinel<I> S, class Proj = ranges::identity,           IndirectUnaryInvocable<projected<I, Proj>> Fun > ranges::tagged_pair<tag::in(I), tag::fun(Fun)>     for_each( I first, S last, Fun f, Proj proj = Proj{} );	(1)	(ranges TS)
template< InputRange R, class Proj = ranges::identity,           IndirectUnaryInvocable<projected<ranges::iterator_t<R>, Proj>> Fun > ranges::tagged_pair<tag::in(ranges::safe_iterator_t<R>), tag::fun(Fun)>     for_each( R&& r, Fun f, Proj proj = Proj{} );	(2)	(ranges TS)

1) 对范围 [first, last) 中每个迭代器解引用的结果应用投影 proj，然后对投影结果调用给定的函数对象 f（即 ranges::invoke(f, ranges::invoke(proj, *i))），按顺序进行调用。

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

对于两个重载版本，如果迭代器类型是可变的，f 可以通过解引用的迭代器修改范围内的元素。如果 f 返回结果，结果将被忽略。

与其他算法不同，即使序列中的元素是可平凡复制的，for_each 也不允许复制它们。

与 std::for_each（仅要求 MoveConstructible）不同，这些函数要求 Fun 建模 CopyConstructible。

尽管上面描述了声明，但算法声明的模板参数的实际数量和顺序是未指定的。因此，如果在调用算法时使用了显式模板参数，则该程序可能不具有可移植性。

参数

first, last	-	应用函数的范围
r	-	应用函数的范围
f	-	要应用于范围内每个投影元素的可调用对象
proj	-	应用于元素的投影

返回值

一个 tagged_pair 对象，包含以下两个成员

• 第一个成员，带有标签 tag::in，是源范围的过尾迭代器（即，类型为 I 且与哨兵 last 相等的迭代器）。
• 第二个成员，带有标签 tag::fun，从 std::move(f) 初始化（在函数对象的所有应用之后）。

复杂度

正好 last - first 次 f 和 proj 的应用。

可能的实现

template<InputIterator I, Sentinel<I> S, class Proj = ranges::identity, IndirectUnaryInvocable<ranges::projected<I, Proj>> Fun> auto for_each(I first, S last, Fun f, Proj proj = Proj{}) -> ranges::tagged_pair<tag::in(I), tag::fun(Fun)> { for (; first != last; ++first) ranges::invoke(f, ranges::invoke(proj, *first)); return {std::move(first), std::move(f)}; }

参见

transform	将函数应用于元素范围 (函数模板)
range-for 循环(C++11)	在范围上执行循环
for_each	将一元函数对象应用于来自范围的元素 (函数模板)
for_each_n (C++17)	将函数对象应用于序列的前 N 个元素 (函数模板)