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

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_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) 指定されていれば引数 token を処理系定義の方法で使用して、新しい std::random_device オブジェクトを構築します。

3) コピーコンストラクタは削除されています。 std::random_device はコピー可能でもムーブ可能でもありません。

例外

失敗した場合は std::exception から派生した処理系定義の例外を投げます。

ノート

libstdc++ の実装は token がランダムバイトのソースの名前を表すことを期待します。 取り得る token の値には "default"、 "rand_s"、 "rdseed"、 "rdrand"、 "rdrnd"、 "/dev/urandom"、 "/dev/random"、 "mt19937" および mt19937 エンジンのシードを指定する整数文字列があります。 ("default" 以外の token の値は特定のターゲットに対してのみ有効です。)

libc++ の実装は、ソースとしてキャラクタデバイスを使用するようにコンフィグレーションされているときは、 token が読み込んだときに乱数を生成するキャラクタデバイスの名前を表すことを期待します。 そうでなければ token は "/dev/urandom" であることを期待します。

欠陥報告

以下の動作変更欠陥報告は以前に発行された C++ 標準に遡って適用されました。

DR	適用先	発行時の動作	正しい動作
P0935R0	C++11	default constructor was explicit	made implicit

例

Linux で利用可能な一般的な2種類の std::random_device をデモンストレーションします。

Run this code

#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