std::uniform_int_distribution

< cpp‎ | numeric‎ | random
 
C++
 
数值库
常用数学函数
数学特殊函数 (C++17)
数学常数 (C++20)
浮点环境 (C++11)
复数
数值数组
伪随机数生成
编译时有理数算术 (C++11)
数值算法
(C++17)
(C++17)
插值
(C++20)
(C++20)
通用数值运算
(C++11)
位操作
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
 
伪随机数生成
均匀随机位生成器
(C++20)
引擎及引擎适配器
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
非确定性生成器
(C++11)
分布
均匀分布
uniform_int_distribution
(C++11)
(C++11)
(C++11)
伯努利分布
(C++11)
(C++11)
(C++11)
(C++11)
泊松分布
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
正态分布
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
采样分布
(C++11)
(C++11)
(C++11)
种子序列
(C++11)
C 库
 
std::uniform_int_distribution
 
定义于头文件 <random>
template< class IntType = int >
class uniform_int_distribution;
 (C++11 起)

生成随机整数值 i ，均匀分布于闭区间 [a, b] ，即按照以下离散概率函数分布

P(i|a,b) =
1
b − a + 1
 。

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

模板形参

IntType - 生成器所生成的结果类型。若它不是 short 、 int 、 long 、 long long 、 unsigned short 、 unsigned int 、 unsigned long 或 unsigned long long 之一则效果未定义。


成员类型

 
成员类型 定义
result_type IntType
param_type 参数集的类型，见随机数分布 (RandomNumberDistribution) 。

成员函数

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

非成员函数

 比较两个分布对象
(函数)
执行伪随机数分布的流输入和输出
(函数模板)

示例

此程序模拟 6 面骰子。

运行此代码
#include <random>
#include <iostream>
 
int main()
{
    std::random_device rd;  // 将用于为随机数引擎获得种子
    std::mt19937 gen(rd()); // 以播种标准 mersenne_twister_engine
    std::uniform_int_distribution<> dis(1, 6);
 
    for (int n=0; n<10; ++n)
        // 用 dis 变换 gen 所生成的随机 unsigned int 到 [1, 6] 中的 int
        std::cout << dis(gen) << ' ';
    std::cout << '\n';
}

可能的输出： 

1 1 6 5 2 2 5 5 6 2