std::for_each

来自cppreference.com
< cpp‎ | algorithm


 
 
算法库
执行策略 (C++17)
不修改的序列操作
all_of
any_of
none_of
(C++11)
(C++11)
(C++11)
for_each
for_each_n(C++17)
修改的序列操作
未初始化存储上的操作
划分操作
排序操作
is_sorted(C++11)
is_sorted_until(C++11)
二分查找操作
集合操作(在已排序范围上)
堆操作
is_heap(C++11)
is_heap_until(C++11)
最小/最大操作
minmax(C++11)
minmax_element(C++11)
clamp(C++17)

重排
数值操作
C 库
 
定义于头文件 <algorithm>
template< class InputIt, class UnaryFunction >
UnaryFunction for_each( InputIt first, InputIt last, UnaryFunction f );

将给定的函数f的结果运用在从[first, last)每一个迭代器所指向的内容,依照顺序。 如果InputIt是一个可变的迭代器,f可以通过解引用迭代器来修改处于范围内的元素。如果f返回一个结果,该结果将被忽略.

目录

[编辑] 参数

first, last -
的范围内应用的功能
原文:
the range to apply the function to
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
f -
一元函数对象
原文:
the unary function object to be applied
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
类型要求
-
InputIt必须满足 InputIterator的要求。
-
UnaryFunction必须满足 MoveConstructible 的要求。Does not have to be CopyConstructible

[编辑] 返回值

f. (C++11 前)
std::move(f). (C++11 起)

[编辑] 复杂度

精确的(last - first)(即f的大小)的复杂度

[编辑] 可能的实现

template<class InputIt, class UnaryFunction>
UnaryFunction for_each(InputIt first, InputIt last, UnaryFunction f)
{
    for (; first != last; ++first) {
        f(*first);
    }
    return f;
}

[编辑] 示例

下面的示例使用了lambda函数递增一个向量的所有元素,然后计算它们的总和:
原文:
The following example uses a lambda函数 to increment all of the elements of a vector and then computes a sum of them:
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里

#include <vector>
#include <algorithm>
#include <iostream>
 
struct Sum {
    Sum() { sum = 0; }
    void operator()(int n) { sum += n; }
 
    int sum;
};
 
int main()
{
    std::vector<int> nums{3, 4, 2, 9, 15, 267};
 
    std::cout << "before: ";
    for (auto n : nums) {
        std::cout << n << " ";
    }
    std::cout << '\n';
 
    std::for_each(nums.begin(), nums.end(), [](int &n){ n++; });
    Sum s = std::for_each(nums.begin(), nums.end(), Sum());
 
    std::cout << "after:  ";
    for (auto n : nums) {
        std::cout << n << " ";
    }
    std::cout << '\n';
    std::cout << "sum: " << s.sum << '\n';
}

输出:

before: 3 4 2 9 15 267
after:  4 5 3 10 16 268
sum: 306

[编辑] 另请参阅

将一个函数应用于某一范围的元素
(函数模板) [edit]
范围的循环
执行循环范围(C++11 起)
原文:
executes loop over range (C++11 起)
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
[edit]