std::ranges::for_each
定义于头文件 <algorithm>
|
||
template< std::input_iterator I, std::sentinel_for<I> S, class Proj = std::identity, std::indirectly_unary_invocable<std::projected<I, Proj>> Fun > |
(1) | (C++20 起) |
template< ranges::input_range R, class Proj = std::identity, std::indirectly_unary_invocable<std::projected<ranges::iterator_t<R>, Proj>> Fun > |
(2) | (C++20 起) |
1) 将给定的函数对象
f
应用于范围[first, last)
中每个迭代器投影的值的结果,按顺序排列。2) 与 (1)相同,但使用
r
作为源范围, 就像使用ranges::begin(r)作为first
和 ranges::end(r) 作为 last
结尾一样。对于这两个重载,如果迭代器的类型是mutable, f
可能会通过取消引用的迭代器去修改范围中的元素。如果f
返回了一个结果,则忽略此结果。
参数
first, last | - | iterator-sentinel pair denoting the range to apply the function to |
r | - | 要将函数应用到的元素范围 |
f | - | the function to apply to the projected range |
proj | - | projection to apply to the elements |
返回值
{first, std::move(f)}, 当 first == last
复杂度
显式 last
- first
应用 f
和proj
可能的实现
struct for_each_fn { template<std::input_iterator I, std::sentinel_for<I> S, class Proj = std::identity, std::indirectly_unary_invocable<std::projected<I, Proj>> Fun> constexpr ranges::for_each_result<I, Fun> operator()(I first, S last, Fun f, Proj proj = {}) const { for (; first != last; ++first) { std::invoke(f, std::invoke(proj, *first)); } return {std::move(first), std::move(f)}; } template<ranges::input_range R, class Proj = std::identity, std::indirectly_unary_invocable<std::projected<ranges::iterator_t<R>, Proj>> Fun> constexpr ranges::for_each_result<ranges::borrowed_iterator_t<R>, Fun> operator()(R&& r, Fun f, Proj proj = {}) const { return (*this)(ranges::begin(r), ranges::end(r), std::move(f), std::ref(proj)); } }; inline constexpr for_each_fn for_each; |
示例
下述的示例使用了 lambda object递增vector所有的元素, 然后使用一个重载的 operator()
在 functor中去计算它们的和。注意,要计算总和的话,建议使用专用算法std::accumulate。
运行此代码
#include <algorithm> #include <iostream> #include <utility> #include <vector> struct Sum { void operator()(int n) { sum += n; } int sum{0}; }; int main() { std::vector<int> nums{3, 4, 2, 8, 15, 267}; auto print = [](const int& n) { std::cout << " " << n; }; namespace ranges = std::ranges; std::cout << "before:"; ranges::for_each(std::as_const(nums), print); std::cout << '\n'; ranges::for_each(nums, [](int& n){ ++n; }); // calls Sum::operator() for each number auto [i, s] = ranges::for_each(nums.begin(), nums.end(), Sum()); std::cout << "after: "; ranges::for_each(nums.cbegin(), nums.cend(), print); std::cout << '\n'; std::cout << "sum: " << s.sum << '\n'; }
输出:
before: 3 4 2 8 15 267 after: 4 5 3 9 16 268 sum: 305
参阅
范围 for 循环(C++11)
|
执行范围上的循环 |
(C++20) |
将一个函数应用于某一范围的各个元素 (niebloid) |
(C++20) |
应用函数对象到序列的首 n 个元素 (niebloid) |
应用函数到范围中的元素 (函数模板) |