| | |
template<class RealType,std::size_t Bits,class Generator> RealType generate_canonical( Generator& g); | | (since C++11) |
| | |
Generates a random floating point number in range[
0,
1)
.
To generate enough entropy,generate_canonical() will callg() exactly\(\small k\)k times, where\(\small k = \max(1, \lceil \frac{b}{\log_2 R} \rceil)\)k = max(1, ⌈ b / log2 R ⌉) and
[edit]Parameters
g | - | generator to use to acquire entropy |
[edit]Return value
Floating point value in range[
0,
1)
.
[edit]Exceptions
None except from those thrown byg.
Some existing implementations have a bug where they may occasionally return1.0 ifRealType
isfloatGCC #63176LLVM #18767MSVC STL #1074. This isLWG issue 2524.
[edit]Example
Produce random numbers with 10 bits of randomness: this may produce onlyk* R distinct values.
Possible output:
0.208143 0.824147 0.0278604 0.343183 0.0173263 0.864057 0.647037 0.539467 0.0583497 0.609219
[edit]See also
| produces real values evenly distributed across a range (class template)[edit] |