命名空间
变体
操作

std::for_each

来自 cppreference.com
< cpp‎ | algorithm
 
 
算法库
受约束的算法和范围上的算法 (C++20)
受约束的算法,例如 ranges::copyranges::sort
执行策略 (C++17)
排序和相关操作
分区操作
排序操作
二分查找操作
(在已分区范围上)
集合操作 (在已排序范围上)
合并操作 (在已排序范围上)
堆操作
最小/最大操作
(C++11)
(C++17)
字典序比较操作
排列操作
C 库
数值操作
对未初始化内存的操作
 
在头文件 <algorithm> 中定义
template< class InputIt, class UnaryFunc >
UnaryFunc for_each( InputIt first, InputIt last, UnaryFunc f );
(1) (constexpr 自 C++20 起)
template< class ExecutionPolicy, class ForwardIt, class UnaryFunc >

void for_each( ExecutionPolicy&& policy,

               ForwardIt first, ForwardIt last, UnaryFunc f );
(2) (自 C++17 起)

将给定的函数对象 f 应用于范围 [firstlast) 中每个迭代器解引用的结果。如果 f 返回结果,则忽略该结果。

1)first 开始按顺序应用 f

如果 UnaryFunc 不是 可移动构造 的,则行为未定义。

(自 C++11 起)
2) f 可能不会按顺序应用。该算法根据 policy 执行。
仅当

std::is_execution_policy_v<std::decay_t<ExecutionPolicy>>true 时,此重载才参与重载决议。

(直至 C++20)

std::is_execution_policy_v<std::remove_cvref_t<ExecutionPolicy>>true

(自 C++20 起)
UnaryFunc可复制构造,则行为未定义。

若迭代器类型 (InputIt/ForwardIt) 是可变的,则 f 可以通过解引用的迭代器修改范围中的元素。

与其余并行算法不同,即使序列中的元素 可平凡复制for_each 也不允许创建它们的副本。

目录

[编辑] 参数

first, last - 要对其应用函数的范围
policy - 要使用的执行策略。 细节参见 执行策略
f - 函数对象,要应用于范围 [firstlast) 中每个迭代器解引用的结果

函数的签名应等价于以下内容

 void fun(const Type &a);

签名不需要有 const &
类型  Type 必须使得可以解引用类型 InputIt 的对象,然后将其隐式转换为  Type

类型要求
-
InputIt 必须满足 旧式输入迭代器 的要求。
-
ForwardIt 必须满足 旧式前向迭代器 的要求。

[编辑] 返回值

1) f
2) (无)

[编辑] 复杂度

恰好应用 std::distance(first, last)f

[编辑] 异常

带有名为 ExecutionPolicy 的模板参数的重载按如下方式报告错误

  • 若作为算法的一部分调用的函数的执行抛出异常且 ExecutionPolicy标准策略 之一,则调用 std::terminate。 对于任何其他 ExecutionPolicy,行为是实现定义的。
  • 若算法未能分配内存,则抛出 std::bad_alloc

[编辑] 可能的实现

另见 libstdc++libc++MSVC stdlib 中的实现。

template<class InputIt, class UnaryFunc>
constexpr UnaryFunc for_each(InputIt first, InputIt last, UnaryFunc f)
{
    for (; first != last; ++first)
        f(*first);
 
    return f; // implicit move since C++11
}

[编辑] 注意

对于重载 (1)f 可以是有状态函数对象。 返回值可以视为批处理操作的最终状态。

对于重载 (2),可以创建 f 的多个副本以执行并行调用。 不返回值是因为并行化通常不允许高效的状态累积。

[编辑] 示例

以下示例使用 lambda 表达式 增加向量的所有元素,然后在函数对象(又称“函子”)中使用重载的 operator() 计算它们的总和。 请注意,要计算总和,建议使用专用算法 std::accumulate

#include <algorithm>
#include <iostream>
#include <vector>
 
int main()
{
    std::vector<int> v{3, -4, 2, -8, 15, 267};
 
    auto print = [](const int& n) { std::cout << n << ' '; };
 
    std::cout << "before:\t";
    std::for_each(v.cbegin(), v.cend(), print);
    std::cout << '\n';
 
    // increment elements in-place
    std::for_each(v.begin(), v.end(), [](int &n) { n++; });
 
    std::cout << "after:\t";
    std::for_each(v.cbegin(), v.cend(), print);
    std::cout << '\n';
 
    struct Sum
    {
        void operator()(int n) { sum += n; }
        int sum {0};
    };
 
    // invoke Sum::operator() for each element
    Sum s = std::for_each(v.cbegin(), v.cend(), Sum());    
    std::cout << "sum:\t" << s.sum << '\n';
}

输出

before:	3 -4 2 -8 15 267 
after:	4 -3 3 -7 16 268 
sum:	281

[编辑] 缺陷报告

以下更改行为的缺陷报告已追溯应用于先前发布的 C++ 标准。

DR 应用于 发布时的行为 正确行为
LWG 475 C++98 不清楚 f 是否可以修改
正在迭代的序列的元素(for_each
归类为“非修改序列操作”)
已澄清(若迭代器类型是可变的则允许)
LWG 2747 C++11 重载 (1) 返回 std::move(f) 返回 f(其隐式移动)

[编辑] 参见

将函数应用于元素范围,并将结果存储在目标范围中
(函数模板) [编辑]
将函数对象应用于序列的前 N 个元素
(函数模板) [编辑]
将函数应用于元素范围
(niebloid)[编辑]
将函数对象应用于序列的前 N 个元素
(niebloid)[编辑]
范围-for 循环(C++11) 在范围内执行循环[编辑]