std:: for_each_n

指定された関数オブジェクト f を範囲 [ first , first + n ) 内のすべてのイテレータをデリファレンスした結果に適用します。 f が結果を返す場合、その結果は無視されます。

n >= 0 が true でない場合、動作は未定義です。

イテレータ型（ InputIt / ForwardIt ）が変更可能な場合、 f はデリファレンスされたイテレータを通じて範囲の要素を変更する可能性があります。

他の並列アルゴリズムとは異なり、 for_each_n は、要素が TriviallyCopyable であっても、シーケンス内の要素のコピーを作成することが許可されていません。

パラメータ

戻り値

first に n を加えたイテレータ、あるいはより形式的には std:: advance ( first, n ) と等しいイテレータ。

計算量

厳密に n 回の f の適用。

例外

ExecutionPolicy という名前のテンプレートパラメータを持つオーバーロードは、 以下のようにエラーを報告します：

• アルゴリズムの一部として呼び出された関数の実行が例外をスローした場合、 ExecutionPolicy が 標準ポリシー のいずれかであるとき、 std::terminate が呼び出される。それ以外の ExecutionPolicy については、動作は実装定義である。
• アルゴリズムがメモリの確保に失敗した場合、 std::bad_alloc がスローされる。

実装例

実装については libstdc++ 、 libc++ および MSVC stdlib も参照してください。

template<class InputIt, class Size, class UnaryFunc>
InputIt for_each_n(InputIt first, Size n, UnaryFunc f)
{
    for (Size i = 0; i < n; ++first, (void) ++i)
        f(*first);
    return first;
}

例

#include <algorithm>
#include <iostream>
#include <vector>
void println(auto const& v)
{
    for (auto count{v.size()}; const auto& e : v)
        std::cout << e << (--count ? ", " : "\n");
}
int main()
{
    std::vector<int> vi{1, 2, 3, 4, 5};
    println(vi);
    std::for_each_n(vi.begin(), 3, [](auto& n) { n *= 2; });
    println(vi);
}

1, 2, 3, 4, 5
2, 4, 6, 4, 5

関連項目