Namespaces
Variants

std::ranges::generate_n

来自 zh.cppreference.net
 
 
算法库
受约束算法与范围算法 (C++20)
受约束算法,例如 ranges::copy、ranges::sort……
排序及相关操作
划分操作
(C++11)    

排序操作
二分搜索操作
(在已划分的范围上)
集合操作(在已排序范围上)
合并操作(在已排序范围上)
堆操作
最小/最大操作
(C++11)
(C++17)
字典序比较操作
排列操作


 
受约束算法
此菜单中的所有名称属于命名空间 std::ranges
不修改序列的操作
修改序列的操作
划分操作
排序操作
二分搜索操作(在已排序范围上)
       
       
集合操作(在已排序范围上)
堆操作
最小/最大操作
       
       
排列操作
折叠操作
数值运算
(C++23)            
未初始化存储上的操作
返回类型
 
定义于头文件 <algorithm>
调用签名
template< std::input_or_output_iterator O, std::copy_constructible F >
requires std::invocable<F&> && std::indirectly_writable<O, std::invoke_result_t<F&>>
constexpr O
    generate_n( O first, std::iter_difference_t<O> n, F gen );
(C++20 起)

将函数对象 连续调用的结果赋值给范围 gen中的每个元素[first, first + n),如果 0 < n。否则不执行任何操作。

此页面上描述的函数式实体是 算法函数对象(非正式名称为 niebloid),即:

参数

first - 要修改的元素范围的起始位置
n - 要修改的元素数量
gen - 生成器函数对象

返回值

若 0 < count 则返回指向最后一个被赋值元素后一位置的迭代器,否则返回 first 。

复杂度

恰好需要 n 次 gen ( ) 调用及赋值操作。

可能的实现

struct generate_n_fn
{
    template<std::input_or_output_iterator O, std::copy_constructible F>
    requires std::invocable<F&> && std::indirectly_writable<O, std::invoke_result_t<F&>>
    constexpr O operator()(O first, std::iter_difference_t<O> n, F gen) const
    {
        for (; n-- > 0; *first = std::invoke(gen), ++first)
        {}
        return first;
    }
};
inline constexpr generate_n_fn generate_n {};

示例

#include <algorithm>
#include <array>
#include <iostream>
#include <random>
#include <string_view>
auto dice()
{
    static std::uniform_int_distribution<int> distr {1, 6};
    static std::random_device engine;
    static std::mt19937 noise {engine()};
    return distr(noise);
}
void print(const auto& v, std::string_view comment)
{
    for (int i : v)
        std::cout << i << ' ';
    std::cout << '(' << comment << ")\n";
}
int main()
{
    std::array<int, 8> v;
    std::ranges::generate_n(v.begin(), v.size(), dice);
    print(v, "dice");
    std::ranges::generate_n(v.begin(), v.size(), [n {0}] mutable { return n++; });
    // same effect as std::iota(v.begin(), v.end(), 0);
    print(v, "iota");
}

可能的输出:

5 5 2 2 6 6 3 5 (dice)
0 1 2 3 4 5 6 7 (iota)

参见

将函数调用结果保存到范围中
(算法函数对象)
使用均匀随机位生成器产生的随机数填充范围
(算法函数对象)
为范围中的元素赋予指定值
(算法函数对象)
为指定数量的元素赋予某个值
(算法函数对象)
对范围内的元素应用函数
(算法函数对象)
将连续函数调用的结果赋值给范围中的 N 个元素
(函数模板)