std:: for_each

指定された単項 関数オブジェクト f を、 イテレータ の範囲 レンジ [ first , last ) 内のすべてのイテレータをデリファレンスした結果に適用します。 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';
    // 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++規格に対して遡及的に適用されました。

関連項目