std::mersenne_twister_engine

template<
    class UIntType,
    std::size_t w, std::size_t n, std::size_t m, std::size_t r, UIntType a,
    std::size_t u, UIntType d, std::size_t s, UIntType b, std::size_t t, UIntType c,
    std::size_t l, UIntType f
> class mersenne_twister_engine;

mersenne_twister_engine is a random number engine based on Mersenne Twister algorithm. It produces high quality, but not cryptographically secure, unsigned integer random numbers of type UIntType on the interval \(\scriptsize {[0,2^w)}\)[0, 2^w).

The following type aliases define the random number engine with two commonly used parameter sets:

Template parameters

The following relations shall hold:

• 0 < m ≤ n
• 2 < w
• r ≤ w
• u ≤ w
• s ≤ w
• t ≤ w
• l ≤ w
• w ≤ std::numeric_limits<UIntType>::digits
• a ≤ 2^w-1
• b ≤ 2^w-1
• c ≤ 2^w-1
• d ≤ 2^w-1
• f ≤ 2^w-1

Member types

Member functions

Non-member functions

Member constants

Notes

The N^th consecutive invocation of a default-constructed engine is required to produce the following value:

This is to guarantee that the random engine is conforming to the standard (see N1398).

#include <cassert>
#include <random>
 
int main()
{
    std::mt19937 gen32;
    std::mt19937_64 gen64;
 
    gen32.discard(10'000 - 1);
    gen64.discard(10'000 - 1);
 
    assert(gen32() == 4'123'659'995);
    assert(gen64() == 9'981'545'732'273'789'042ull);
}