std::generate_canonical

 

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

 

ヘッダ <random> で定義
template<class RealType, size_t bits, class Generator > RealType generate_canonical( Generator& g );		(C++11以上)

範囲 [0, 1) 内のランダムな浮動小数点数を生成します。

十分なエントロピーを生成するために、 generate_canonical() は g() をちょうど k 回呼びます。 ただし、 \(k = \text{Max}(1, \lceil \frac{b}{\log_2 R} \rceil)\)k = max(1, ⌈ b / log
2 R ⌉) であり、

• b =std::min<std::size_t>(bits, std::numeric_limits<RealType>::digits)
• R = g.max()- g.min()+1

です。

引数

g

-

エントロピーを取得するために使用するジェネレータ

戻り値

範囲 [0, 1) 内の浮動小数点値。

例外

g が投げるもの以外はありません。

ノート

既存の処理系には、 RealType が float の場合に時折 1.0 を返す可能性があるバグを持つものがあります (GCC #63176, LLVM #18767)。 LWG issue 2524 も参照してください。

例

10ビットのランダム性を持つ乱数を生成します。 これは異なる値を k*R 個しか生成しないかもしれません。

Run this code

#include <random>#include <iostream>   int main(){std::random_device rd;std::mt19937 gen(rd());for(int n=0; n<10;++n){std::cout<< std::generate_canonical<double, 10>(gen)<<' ';}}

出力:

0.208143 0.824147 0.0278604 0.343183 0.0173263 0.864057 0.647037 0.539467 0.0583497 0.609219

関連項目

uniform_real_distribution (C++11)

範囲内に一様に分布した実数値を生成します (クラステンプレート)