std::for_each_n

ヘッダ `<algorithm>` で定義
	(1)
template< class InputIt, class Size, class UnaryFunction > InputIt for_each_n( InputIt first, Size n, UnaryFunction f );			(C++17およびそれ以降) (C++20以前)
template< class InputIt, class Size, class UnaryFunction > constexpr InputIt for_each_n( InputIt first, Size n, UnaryFunction f );			(C++20およびそれ以降)
template< class ExecutionPolicy, class ForwardIt, class Size, class UnaryFunction2 > ForwardIt for_each_n( ExecutionPolicy&& policy, ForwardIt first, Size n, UnaryFunction2 f );		(2)	(C++17およびそれ以降)

1) 指定された関数オブジェクト f を範囲 [first, first + n) 内のすべてのイテレータを逆参照した結果に順番に適用します。

2) 指定された関数オブジェクト f を範囲 [first, first + n) 内のすべてのイテレータを逆参照した結果に適用します (順番にとは限りません)。アルゴリズムは policy に従って実行されます。このオーバーロードは、 std::is_execution_policy_v<std::decay_t<ExecutionPolicy>> が true でなければ、オーバーロード解決に参加しません。

どちらのオーバーロードについても、イテレータの型が可変であれば、 f は逆参照されたイテレータを通して範囲内の要素を変更しても構いません。 f が結果を返す場合、その結果は無視されます。 n がゼロより小さい場合、動作は未定義です。

first	-	関数を適用する範囲の先頭
n	-	関数を適用する要素の数
policy	-	使用する実行ポリシー。詳細は実行ポリシーを参照してください
f	-	範囲 `[first, first + n)` 内のすべてのイテレータを逆参照した結果に適用される関数オブジェクト。関数のシグネチャは以下と同等であるべきです。 void fun(const Type &a); シグネチャが const & を持つ必要はありません。型 Type は InputIt 型のオブジェクトの逆参照から暗黙に変換可能なものでなければなりません。
型の要件
- `InputIt` は `InputIterator` の要件を満たさなければなりません。
- `ForwardIt` は `ForwardIterator` の要件を満たさなければなりません。
- `UnaryFunction` は `MoveConstructible` の要件を満たさなければなりません。 `CopyConstructible` である必要はありません。
- `UnaryFunction2` は `CopyConstructible` の要件を満たさなければなりません。

[編集] 戻り値

first + n。

[編集] 計算量

ちょうど n 回の f の適用。

[編集] 例外

テンプレート引数 ExecutionPolicy を持つオーバーロードは以下のようにエラーを報告します。

アルゴリズムの一部として呼び出された関数の実行が例外を投げ、 ExecutionPolicy が3つの標準のポリシーのいずれかの場合は、 std::terminate が呼ばれます。それ以外のあらゆる ExecutionPolicy については、動作は処理系定義です。
アルゴリズムがメモリの確保に失敗した場合は、 std::bad_alloc が投げられます。

[編集] 実装例

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

[編集] 例

Run this code

#include <algorithm>
#include <iostream>
#include <vector>
 
int main()
{
    std::vector<int> ns{1, 2, 3, 4, 5};
    for (auto n: ns) std::cout << n << ", ";
    std::cout << '\n';
    std::for_each_n(ns.begin(), 3, [](auto& n){ n *= 2; });
    for (auto n: ns) std::cout << n << ", ";
    std::cout << '\n';
}

出力:

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

[編集] 関連項目

transform	指定範囲の要素に関数を適用します (関数テンプレート) [edit]
範囲 for ループ	範囲に対してループを実行します (C++11およびそれ以降) [edit]
for_each	指定範囲の要素に関数を適用します (関数テンプレート) [edit]

言語
ヘッダ
コンセプト
言語サポートライブラリ
診断ライブラリ
ユーティリティライブラリ
文字列ライブラリ
コンテナライブラリ
アルゴリズムライブラリ
イテレータライブラリ
数値演算ライブラリ
入出力ライブラリ
ローカライゼーションライブラリ
正規表現ライブラリ (C++11)
アトミック操作ライブラリ (C++11)
スレッドサポートライブラリ (C++11)
ファイルシステムライブラリ (C++17)
技術仕様書

cppreference.com

検索

名前空間

変種

表示

操作