Difference between revisions of "cpp/numeric/random/random device"
From cppreference.com
(Undo revision 137486 by 195.14.232.22 (talk)) |
m (→Notes: de-capitalized V) |
||
Line 31: | Line 31: | ||
===Notes=== | ===Notes=== | ||
− | A notable implementation where {{tt|std::random_device}} is deterministic is old versions of MinGW ([https://sourceforge.net/p/mingw-w64/bugs/338/ bug 338], fixed since GCC 9.2). The latest MinGW | + | A notable implementation where {{tt|std::random_device}} is deterministic is old versions of MinGW ([https://sourceforge.net/p/mingw-w64/bugs/338/ bug 338], fixed since GCC 9.2). The latest MinGW versions can be downloaded from [https://gcc-mcf.lhmouse.com/ GCC with the MCF thread model]. |
===Example=== | ===Example=== |
Revision as of 13:49, 24 January 2022
Defined in header <random>
|
||
class random_device; |
(since C++11) | |
std::random_device
is a uniformly-distributed integer random number generator that produces non-deterministic random numbers.
std::random_device
may be implemented in terms of an implementation-defined pseudo-random number engine if a non-deterministic source (e.g. a hardware device) is not available to the implementation. In this case each std::random_device
object may generate the same number sequence.
Contents |
Member types
Member type | Definition |
result_type
|
unsigned int |
Member functions
Construction | |
constructs the engine (public member function) | |
operator= (deleted) |
the assignment operator is deleted (public member function) |
Generation | |
advances the engine's state and returns the generated value (public member function) | |
Characteristics | |
(C++11) |
obtains the entropy estimate for the non-deterministic random number generator (public member function) |
[static] |
gets the smallest possible value in the output range (public static member function) |
[static] |
gets the largest possible value in the output range (public static member function) |
Notes
A notable implementation where std::random_device
is deterministic is old versions of MinGW (bug 338, fixed since GCC 9.2). The latest MinGW versions can be downloaded from GCC with the MCF thread model.
Example
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)]; // note: demo only: the performance of many // implementations of random_device degrades sharply // once the entropy pool is exhausted. For practical use // random_device is generally only used to seed // a PRNG such as mt19937 } for (auto p : hist) { std::cout << p.first << " : " << std::string(p.second/100, '*') << '\n'; } }
Possible output:
0 : ******************** 1 : ******************* 2 : ******************** 3 : ******************** 4 : ******************** 5 : ******************* 6 : ******************** 7 : ******************** 8 : ******************* 9 : ********************