std::piecewise_constant_distribution

定义于头文件 `<random>`
template< class RealType = double > class piecewise_constant_distribution;		(since C++11)

std::piecewise_constant_distribution 生成随机浮点数，这些数字在若干子区间 $[b i, b i+1)$ 内均匀分布，每个子区间都有其自身的权重 $w i$ 。区间边界集合和权重集合是此分布的参数。

对于任何

b i \leq x <b i+1

，概率密度为

w i S (b i+1 - b i)

，其中

S

是所有权重的总和。

std::piecewise_constant_distribution 满足 RandomNumberDistribution 的所有要求。

[编辑] 模板参数

RealType

-

生成器生成的结果类型。如果这不是 float、 double 或 long double 之一，则效果未定义。

[编辑] 成员类型

成员类型	定义
`result_type` (C++11)	RealType
`param_type` (C++11)	参数集类型，参见 RandomNumberDistribution。

[编辑] 成员函数

(构造函数) (C++11)	构造新的分布 (public member function) [编辑]
reset (C++11)	重置分布的内部状态 (public member function) [编辑]
生成
operator() (C++11)	生成分布中的下一个随机数 (public member function) [编辑]
特性
intervalsdensities	返回分布参数 (public member function) [编辑]
param (C++11)	获取或设置分布参数对象 (public member function) [编辑]
min (C++11)	返回可能生成的最小值 (public member function) [编辑]
max (C++11)	返回可能生成的最大值 (public member function) [编辑]

[编辑] 非成员函数

operator==operator!= (C++11)(C++11)(C++20 中移除)	比较两个分布对象 (function) [编辑]
operator<<operator>> (C++11)	对伪随机数分布执行流输入和输出 (function template) [编辑]

[编辑] 示例

运行此代码

#include <iostream>
#include <map>
#include <random>
#include <string>
 
int main()
{
    std::random_device rd;
    std::mt19937 gen(rd());
    // 50% of the time, generate a random number between 0 and 1
    // 50% of the time, generate a random number between 10 and 15
    std::vector<double> i {0, 1, 10, 15};
    std::vector<double> w {1, 0, 1};
    std::piecewise_constant_distribution<> d(i.begin(), i.end(), w.begin());
 
    std::map<int, int> hist;
    for (int n {}; n < 1e4; ++n)
        ++hist[d(gen)];
 
    for (std::cout << std::hex << std::uppercase; auto [x, y] : hist)
        std::cout << x << ' ' << std::string(y / 100, '*') << '\n';
}

可能的输出

0 **************************************************
A **********
B *********
C *********
D **********
E *********

[编辑] 参考

C++23 标准 (ISO/IEC 14882:2024)

28.5.9.6.2 类模板 piecewise_constant_distribution [rand.dist.samp.pconst] (p: 1421-1422)

C++20 标准 (ISO/IEC 14882:2020)

29.6.9.6.2 类模板 piecewise_constant_distribution [rand.dist.samp.pconst] (p: 1207-1208)

C++17 标准 (ISO/IEC 14882:2017)

29.6.8.6.2 类模板 piecewise_constant_distribution [rand.dist.samp.pconst] (p: 1098-1100)

C++14 标准 (ISO/IEC 14882:2014)

26.5.8.6.2 类模板 piecewise_constant_distribution [rand.dist.samp.pconst] (p: 962-964)

C++11 标准 (ISO/IEC 14882:2011)

26.5.8.6.2 类模板 piecewise_constant_distribution [rand.dist.samp.pconst] (p: 955-957)

编译器支持
独立和宿主
语言
标准库
标准库头文件
具名要求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
诊断库
内存管理库
元编程库 (C++11)
通用工具库
容器库
迭代器库
范围库 (C++20)
算法库
字符串库
文本处理库
数值库
日期和时间库
输入/输出库
文件系统库 (C++17)
并发支持库 (C++11)
执行控制库 (C++26)
技术规范
符号索引
外部库

成员函数
piecewise_constant_distribution::piecewise_constant_distribution
piecewise_constant_distribution::reset
生成
piecewise_constant_distribution::operator()
特性
piecewise_constant_distribution::intervalspiecewise_constant_distribution::densities
piecewise_constant_distribution::param
piecewise_constant_distribution::min
piecewise_constant_distribution::max
非成员函数
operator==operator!= (C++11)(C++11)(直到 C++20)
operator<<operator>> (C++11)(C++11)

cppreference.cn

命名空间

变体

视图

动作