std:: for_each

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

如果迭代器类型（ InputIt / ForwardIt ）是可变的， f 可能通过解引用迭代器来修改 范围 内的元素。

与其他并行算法不同， for_each 不允许复制序列中的元素，即使它们是 TriviallyCopyable 的。

参数

返回值

复杂度

恰好应用 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; // 自 C++11 起隐式移动
}

注释

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

对于重载 ( 2 ) ，可能会创建多个 f 的副本来执行并行调用。该重载不返回值，因为并行化通常无法实现高效的状态累积。

示例

#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';
    // 就地递增元素
    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};
    };
    // 对每个元素调用 Sum::operator()
    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++ 标准。

参见