std::piecewise_constant_distribution

来自cppreference.com
< cpp‎ | numeric‎ | random
 
 
 
 
 
在标头 <random> 定义
template< class RealType = double >
class piecewise_constant_distribution;
(C++11 起)

std::piecewise_constant_distribution 产生随机浮点数,在分别带有自身权重的 w
i
的数个子区间 [b
i
, b
i+1
)
中的每一个上均匀分布。区间边界集合与权重集合为此分布的参数。

任何 b
i
≤x<b
i+1
上的概率密度为
w
i
S (b
i+1
- b
i
)
,其中 S 为所有权重之和。

std::piecewise_constant_distribution 满足随机数分布 (RandomNumberDistribution) 的所有要求。

模板形参

RealType - 生成器所生成的结果类型。如果它不是 floatdoublelong double 之一,那么效果未定义。

成员类型

成员类型 定义
result_type (C++11) RealType
param_type(C++11) 参数集的类型,见随机数分布 (RandomNumberDistribution)

成员函数

构造新分布
(公开成员函数)
(C++11)
重置分布的内部状态
(公开成员函数)
生成
生成分布中的下个随机数
(公开成员函数)
特征
返回分布参数
(公开成员函数)
(C++11)
获取或设置随机参数对象
(公开成员函数)
(C++11)
返回最小的潜在生成值
(公开成员函数)
(C++11)
返回最大的潜在生成值
(公开成员函数)

非成员函数

(C++11)(C++11)(C++20 中移除)
比较两个分布对象
(函数)
执行伪随机数分布的流输入和输出
(函数模板)

示例

#include <iostream>
#include <map>
#include <random>
#include <string>
 
int main()
{
    std::random_device rd;
    std::mt19937 gen(rd());
    // 50% 时间生成 0 与 1 间的随机数
    // 50% 时间生成 10 与 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 Class template piecewise_constant_distribution [rand.dist.samp.pconst](第 1421-1422 页)
  • C++20 标准(ISO/IEC 14882:2020):
  • 29.6.9.6.2 Class template piecewise_constant_distribution [rand.dist.samp.pconst](第 1207-1208 页)
  • C++17 标准(ISO/IEC 14882:2017):
  • 29.6.8.6.2 Class template piecewise_constant_distribution [rand.dist.samp.pconst](第 1098-1100 页)
  • C++14 标准(ISO/IEC 14882:2014):
  • 26.5.8.6.2 Class template piecewise_constant_distribution [rand.dist.samp.pconst](第 962-964 页)
  • C++11 标准(ISO/IEC 14882:2011):
  • 26.5.8.6.2 Class template piecewise_constant_distribution [rand.dist.samp.pconst](第 955-957 页)