std::normal_distribution

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

输入/输出库

本地化库

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

文件系统库 (C++17)

技术规范

 

数值库

常用数学函数

数学特殊函数 (C++17)

数学常数 (C++20)

浮点环境 (C++11)

复数

数值数组

伪随机数生成

编译时有理数算术 (C++11)

数值算法

gcd (C++17)

lcm (C++17)

插值

midpoint (C++20)

lerp (C++20)

通用数值运算

iota (C++11)

accumulate

inner_product

adjacent_difference

partial_sum

位操作

bit_cast (C++20)

ispow2 (C++20)

ceil2 (C++20)

floor2 (C++20)

log2p1 (C++20)

rotl (C++20)

rotr (C++20)

countl_zero (C++20)

countl_one (C++20)

countr_zero (C++20)

countr_one (C++20)

popcount (C++20)

endian (C++20)

 

伪随机数生成

均匀随机位生成器

uniform_random_bit_generator (C++20)

引擎及引擎适配器

linear_congruential_engine (C++11)

mersenne_twister_engine (C++11)

subtract_with_carry_engine (C++11)

discard_block_engine (C++11)

independent_bits_engine (C++11)

shuffle_order_engine (C++11)

非确定性生成器

random_device (C++11)

分布

均匀分布

uniform_int_distribution (C++11)

uniform_real_distribution (C++11)

generate_canonical (C++11)

伯努利分布

bernoulli_distribution (C++11)

binomial_distribution (C++11)

negative_binomial_distribution (C++11)

geometric_distribution (C++11)

泊松分布

poisson_distribution (C++11)

exponential_distribution (C++11)

gamma_distribution (C++11)

weibull_distribution (C++11)

extreme_value_distribution (C++11)

正态分布

normal_distribution (C++11)

lognormal_distribution (C++11)

chi_squared_distribution (C++11)

cauchy_distribution (C++11)

fisher_f_distribution (C++11)

student_t_distribution (C++11)

采样分布

discrete_distribution (C++11)

piecewise_constant_distribution (C++11)

piecewise_linear_distribution (C++11)

种子序列

seed_seq (C++11)

C 库

rand

srand

RAND_MAX

 

std::normal_distribution

成员函数

normal_distribution::normal_distribution

normal_distribution::reset

生成

normal_distribution::operator()

特征

normal_distribution::meannormal_distribution::stddev

normal_distribution::param

normal_distribution::min

normal_distribution::max

非成员函数

operator==operator!=

operator<<operator>>

 

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

生成服从正态（高斯）随机数分布的随机数。它定义为：

f(x; μ,σ) =

1

σ√2π

exp⎛
⎜
⎝

-1

2

⎛
⎜
⎝

x-μ

σ

⎞
⎟
⎠2
⎞
⎟
⎠

此处 μ 为平均数 (mean) 而 σ 为标准差 (stddev) 。

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

模板形参

RealType

-

生成器所生成的结果类型。若它不是 float 、 double 或 long double 之一则效果未定义。

成员类型

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

成员函数

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

非成员函数

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

示例

运行此代码

#include <iostream>
#include <iomanip>
#include <string>
#include <map>
#include <random>
#include <cmath>
int main()
{
    std::random_device rd{};
    std::mt19937 gen{rd()};
 
    // 值最可能接近平均
    // 标准差影响生成的值距离平均数的分散
    std::normal_distribution<> d{5,2};
 
    std::map<int, int> hist{};
    for(int n=0; n<10000; ++n) {
        ++hist[std::round(d(gen))];
    }
    for(auto p : hist) {
        std::cout << std::setw(2)
                  << p.first << ' ' << std::string(p.second/200, '*') << '\n';
    }
}

可能的输出：

-2 
-1 
 0 
 1 *
 2 ***
 3 ******
 4 ********
 5 **********
 6 ********
 7 *****
 8 ***
 9 *
10 
11 
12

外部链接

• Weisstein, Eric W. “正态分布”来自 MathWorld--A Wolfram Web Resource 。
• 正态分布来自维基百科。