◐ Shell
clean mode source ↗

std::generate_n - cppreference.com

提供: cppreference.com

<tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>

ヘッダ <algorithm> で定義

(1)

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

 (C++11未満)

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

 (C++11以上)
(C++20未満)

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

 (C++20以上)

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

 (2) (C++17以上)

1) count>0 の場合は、 first から始まる範囲の先頭 count 個の要素に、指定された関数オブジェクト g によって生成された値を代入します。 そうでなければ、何もしません。

2) (1) と同じですが、 policy に従って実行されます。 このオーバーロードは、 std::is_execution_policy_v<std::decay_t<ExecutionPolicy>> が true であれば場合にのみ、オーバーロード解決に参加します。

引数

first - 生成する要素の範囲の先頭
count - 生成する要素の数
policy - 使用する実行ポリシー。 詳細は実行ポリシーを参照してください
g - 呼ばれるジェネレータ関数オブジェクト。

関数のシグネチャは以下と同等であるべきです。

<tbody> </tbody>

型 Ret は OutputIt 型のオブジェクトの逆参照に代入可能なものでなければなりません。 ​

型の要件
-OutputIt は LegacyOutputIterator の要件を満たさなければなりません。
-ForwardIt は LegacyForwardIterator の要件を満たさなければなりません。

戻り値

(なし)

(C++11未満)

count>0 の場合は、代入された最後の要素の次を指すイテレータ。 そうでなければ first。

(C++11以上)

計算量

count>0 の場合は、ちょうど count 回の g() の呼び出しおよび代入。

例外

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

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

実装例

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

例

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

int main()
{
    std::mt19937 rng; // デフォルト構築。 固定のシードでシードされます。
    std::generate_n(std::ostream_iterator<std::mt19937::result_type>(std::cout, " "),
                    5, std::ref(rng));
    std::cout << '\n';
}

出力: 

3499211612 581869302 3890346734 3586334585 545404204

関連項目