std::generate_n

template< class OutputIt, class Size, class Generator >
OutputIt generate_n( OutputIt first, Size count, Generator g );

template< class ExecutionPolicy,
          class ForwardIt, class Size, class Generator >
ForwardIt generate_n( ExecutionPolicy&& policy,
                      ForwardIt first, Size count, Generator g );

が Size整数型に変換可能でなければ、プログラムは不適格となる。 目次

first

Ret fun();

の場合は代入された最後の要素の次のイテレータ、count > 0 の場合は first。

計算量

厳密に std::max(0, count) 回の g() の呼び出しと代入。

例外

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

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

実装例

template<class OutputIt, class Size, class Generator>
constexpr // since C++20
OutputIt generate_n(OutputIt first, Size count, Generator g)
{
    for (Size i = 0; i < count; ++i, ++first)
        *first = g();
    
    return first;
}

例

#include <algorithm>
#include <functional>
#include <iostream>
#include <iterator>
#include <random>

int main()
{
    std::mt19937 rng; // default constructed, seeded with fixed seed
    std::generate_n(std::ostream_iterator<std::mt19937::result_type>(std::cout, " "),
                    5, std::ref(rng));
    std::cout << '\n';
}

3499211612 581869302 3890346734 3586334585 545404204

欠陥報告

以下の動作を変更する欠陥報告は、以前に公開されたC++標準に遡って適用された。

関連項目