std::random_device::random_device

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

数值库

常用数学函数

数学特殊函数 (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)

byteswap (C++23)

has_single_bit (C++20)

bit_ceil (C++20)

bit_floor (C++20)

bit_width (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::random_device

成员函数

random_device::random_device (C++11)

生成

random_device::operator() (C++11)

特征

random_device::entropy (C++11)

random_device::min (C++11)

random_device::max (C++11)

 

random_device() : random_device(/*implementation-defined*/) {}	(1)	(C++11 起)
explicit random_device(const std::string& token);	(2)	(C++11 起)
random_device(const random_device& ) = delete;	(3)	(C++11 起)

1) 以实现定义的 token 默认构造新的 std::random_device 对象。

2) 构造新的 std::random_device 对象，若提供则以实现定义行为利用参数 token 。

3) 复制构造函数被删除： std::random_device 不可复制。

异常

失败时抛出从 std::exception 派生的实现定义异常。

注解

libstdc++ 中的实现期待 token 指名随机字节的源。可能的记号值包括 "default" 、 "rand_s" 、 "rdseed" 、 "rdrand" 、 "rdrnd" 、 "/dev/urandom" 、 "/dev/random" 、 "mt19937" 和指定 mt19937 引擎的整数字符串。（除了 "default" 的记号仅在某些目标上可用。）

libc++ 中的实现在配置以字符设备为源时，期待 token 为在从它读取时产生随机数的字符设备的名字；否则它期待 token 为 "/dev/urandom" 。

若提供不支持的记号则 libstdc++ 与 libc++ 均抛出异常。 Microsoft STL 完全忽略记号。

示例

演示 Linux 上 std::random_device 二种常见的可用类型

运行此代码

#include <iostream>
#include <random>
 
int main()
{
 
    std::uniform_int_distribution<int> d(0, 10);
 
    std::random_device rd1; // 使用 RDRND 或 /dev/urandom
    for(int n = 0; n < 10; ++n)
        std::cout << d(rd1) << ' ';
    std::cout << '\n';
 
    std::random_device rd2("/dev/random"); // Linux 上更慢
    for(int n = 0; n < 10; ++n)
        std::cout << d(rd2) << ' ';
    std::cout << '\n';
}

可能的输出：

7 10 7 0 4 4 6 9 4 7 
2 4 10 6 3 2 0 6 3 7

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

DR	应用于	出版时的行为	正确行为
P0935R0	C++11	默认构造函数为 explicit	使之为隐式