std::for_each_n

ヘッダー `<algorithm>` で定義
template< class InputIt, class Size, class UnaryFunc > InputIt for_each_n( InputIt first, Size n, UnaryFunc f );	(1)	(C++17以降) (C++20 以降 constexpr)
template< class ExecutionPolicy, class ForwardIt, class Size, class UnaryFunc > ForwardIt for_each_n( ExecutionPolicy&& policy, ForwardIt first, Size n, UnaryFunc f );	(2)	(C++17以降)

与えられた関数オブジェクト f を、範囲 [first, first + n) 内の各イテレータを間接参照した結果に適用します。 f が結果を返しても、その結果は無視されます。

1) f は first から順に適用されます。

UnaryFunc が MoveConstructible でない場合、動作は未定義です。

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 が CopyConstructible でない場合、動作は未定義です。

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

イテレータの型 (InputIt/ForwardIt) がミュータブルである場合、f は間接参照されたイテレータを通して範囲の要素を変更する可能性があります。

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

first	-	関数を適用する範囲の開始
n	-	関数を適用する要素数
policy	-	使用する実行ポリシー
f	-	関数オブジェクト。範囲 `[`first`,` first + n`)` 内の各イテレータを間接参照した結果に適用されます。関数のシグネチャは以下と同等である必要があります。 void fun(const Type &a); シグネチャは const & を持つ必要はありません。 Type 型は、InputIt 型のオブジェクトを間接参照してから Type 型に暗黙的に変換できるような型でなければなりません。
型要件
- `InputIt` は LegacyInputIterator の要件を満たす必要があります。
- `ForwardIt` は LegacyForwardIterator の要件を満たさなければなりません。
- `Size` は整数型に変換可能でなければなりません。

[edit] 戻り値

first + n に等しいイテレータ、またはより形式的には std::advance(first, n) に等しいイテレータ。

[edit] 計算量

n 回の f の適用。

[edit] 例外

テンプレートパラメータ ExecutionPolicy を持つオーバーロードは、次のようにエラーを報告します。

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

[edit] 実装例

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;
}

[edit] 例

このコードを実行

#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

[edit] 関連項目

transform	範囲内の要素に関数を適用し、結果を結果範囲に格納する (関数テンプレート) [編集]
範囲`for`ループ(C++11)	範囲に対するループを実行する[編集]
for_each	範囲内の要素に単項関数オブジェクトを適用する (関数テンプレート) [編集]
ranges::for_each_n (C++20)	シーケンスの最初のN個の要素に関数オブジェクトを適用する (アルゴリズム関数オブジェクト)[編集]

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

cppreference.com

名前空間

変種

表示

操作