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 不可轉換到整數類型，那麼程序非良構。

參數

Ret fun();

返回值

count > 0 時返回最後被賦值元素後一位置的迭代器。否則返回 first。

複雜度

調用 g() 和賦值各 std::max(0, count) 次。

異常

擁有名為 ExecutionPolicy 的模板形參的重載按下列方式報告錯誤：

• 如果作為算法一部分調用的函數的執行拋出異常，且 ExecutionPolicy 是標準策略之一，那麼調用 std::terminate。對於任何其他 ExecutionPolicy，行為由實現定義。
• 如果算法無法分配內存，那麼拋出 std::bad_alloc。

可能的實現

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

示例

#include <algorithm>
#include <functional>
#include <iostream>
#include <iterator>
#include <random>
 
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

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

參閱