std::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

reduce (C++17)

transform_reduce (C++17)

inclusive_scan (C++17)

exclusive_scan (C++17)

transform_inclusive_scan (C++17)

transform_exclusive_scan (C++17)

ビット操作

bit_cast (C++20)

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

生成

random_device::operator()

特性

random_device::entropy

random_device::min

random_device::max

 

<tbody> </tbody>

ヘッダ <random> で定義
class random_device;		(C++11以上)

std::random_device は非決定的な乱数を生成する一様分布した整数の乱数ジェネレータです。

処理系が非決定的な生成源 (ハードウェアデバイスなど) を利用できない場合、 std::random_device は処理系定義の擬似乱数エンジンを用いて実装されることがあります。 この場合、各 std::random_device オブジェクトは同じ数値列を生成するかもしれません。

メンバ型

メンバ型	定義
result_type	unsigned int

メンバ関数

構築
コンストラクタ	エンジンを構築します (パブリックメンバ関数)
operator= (deleted)	代入演算子は削除されています (パブリックメンバ関数)
生成
operator()	エンジンの状態を進めて生成された値を返します (パブリックメンバ関数)
特性
entropy	非決定的な乱数ジェネレータのエントロピーの見積りを取得します (パブリックメンバ関数)
min [静的]	出力範囲の有り得る最小値を取得します (パブリック静的メンバ関数)
max [静的]	出力範囲の有り得る最大値を取得します (パブリック静的メンバ関数)

ノート

std::random_device が非決定的でない有名な例は古いバージョンの MinGW です (bug 338、 GCC 9.2 で修正されました) が、 mingw-std-random_device のような代替実装もあります。 最新バージョンの MinGW は GCC with the MCF thread model からダウンロードできます。

例

Run this code

#include <iostream>
#include <string>
#include <map>
#include <random>

int main()
{
    std::random_device rd;
    std::map<int, int> hist;
    std::uniform_int_distribution<int> dist(0, 9);
    for (int n = 0; n < 20000; ++n) {
        ++hist[dist(rd)]; // 注: デモ専用です。
                          // random_device の多くの実装はいったんエントロピープールを
                          // 使い果たすと急激に性能が低下します。 実用的な用途のためには
                          // 一般的には mt19937 のような PRNG をシードするためにのみ
                          // random_device を使用します。
    }
    for (auto p : hist) {
        std::cout << p.first << " : " << std::string(p.second/100, '*') << '\n';
    }
}

出力例:

0 : ********************
1 : *******************
2 : ********************
3 : ********************
4 : ********************
5 : *******************
6 : ********************
7 : ********************
8 : *******************
9 : ********************