std::mersenne_twister_engine
| Defined in header <random>
|
||
| template< class UIntType, |
(since C++11) | |
mersenne_twister_engine is a random number engine based on Mersenne Twister algorithm. It produces high quality unsigned integer random numbers of type UIntType on the interval [0, 2w
-1].
The following type aliases define the random number engine with two commonly used parameter sets:
| Defined in header
<random> | |
| Type | Definition |
mt19937
|
std::mersenne_twister_engine<std::uint_fast32_t, 32, 624, 397, 31, |
mt19937_64
|
std::mersenne_twister_engine<std::uint_fast64_t, 64, 312, 156, 31, |
Contents |
[edit] Member types
| Member type | Definition |
result_type
|
The integral type generated by the engine. Results are undefined if this is not an unsigned integral type. |
[edit] Member functions
Construction and Seeding | |
| constructs the engine (public member function) | |
| sets the current state of the engine (public member function) | |
Generation | |
| advances the engine's state and returns the generated value (public member function) | |
| advances the engine's state by a specified amount (public member function) | |
Characteristics | |
| [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) |
[edit] Non-member functions
| compares the internal states of two pseudo-random number engines (function template) | |
| performs stream input and output on pseudo-random number engine (function template) |
[edit] Member objects
| constexpr size_t word_size [static] |
the template parameter w, determines the range of values generated by the engine. (public static member constant) |
| constexpr size_t state_size [static] |
the template parameter n. The engine state is n values of UIntType (public static member constant) |
| constexpr size_t shift_size [static] |
the template parameter m (public static member constant) |
| constexpr size_t mask_bits [static] |
the template parameter r, also known as the twist value. (public static member constant) |
| constexpr UIntType xor_mask [static] |
the template parameter a, the conditional xor-mask. (public static member constant) |
| constexpr size_t tempering_u [static] |
the template parameter u, first component of the bit-scrambling (tempering) matrix (public static member constant) |
| constexpr UIntType tempering_d [static] |
the template parameter d, second component of the bit-scrambling (tempering) matrix (public static member constant) |
| constexpr size_t tempering_s [static] |
the template parameter s, third component of the bit-scrambling (tempering) matrix (public static member constant) |
| constexpr UIntType tempering_b [static] |
the template parameter b, fourth component of the bit-scrambling (tempering) matrix (public static member constant) |
| constexpr size_t tempering_t [static] |
the template parameter t, fifth component of the bit-scrambling (tempering) matrix (public static member constant) |
| constexpr UIntType tempering_c [static] |
the template parameter c, sixth component of the bit-scrambling (tempering) matrix (public static member constant) |
| constexpr size_t tempering_l [static] |
the template parameter l, seventh component of the bit-scrambling (tempering) matrix (public static member constant) |
| constexpr UIntType initialization_multiplier [static] |
the template parameter f (public static member constant) |
| constexpr UIntType default_seed [static] |
the constant value 5489u (public static member constant) |
[edit] Notes
The 10000th consecutive invocation of a default-contructed std::mt19937 is required to produce the value 4123659995.
The 10000th consecutive invocation of a default-contructed std::mt19937_64 is required to produce the value 9981545732273789042