SimpleRandom

Section 24.1 SimpleRandom

Generating pseudo random numbers involves two discrete steps:

Generating some pseudo random bits (a number).

🔗
Mapping that random number on to the range and distribution you want. Do you want numbers 1-6? Do you want 20-2000?

🔗

The C++ random library provides different components for the two jobs and requires users to select which tools to use. This library hides those details and combines the logic of the two steps so that you can just ask for a random value.

🔗

module;

#include <random>

export module SimpleRandom;

std::mt19937 generator{std::random_device{}()};

/**
 * @brief Seeds the random number generator. Calling this function with an
 * integer will seed the generator with that value.
 *
 * @param x Seed value to use.
 *
 * @note If you don't call this function, the generator will
 *       be seeded with a random value.
 */
export void seedRNG(unsigned int x) {
    generator.seed(x);
}

/**
 * @brief Generates a random integer in the range [min, max].
 *
 * @param min The minimum value of the range.
 * @param max The maximum value of the range.
 * @return A random integer in the range [min, max].
 */
export int randRange(int min, int max) {
    std::uniform_int_distribution<int> distribution(min, max);
    return distribution(generator);
}

/**
 * @brief Generates a random double in the range [0.0, 1.0).
 *
 * @return A random double in the range [0.0, 1.0). i.e. 0-0.9999...
 */
export double randDouble() {
    std::uniform_real_distribution<double> distribution(0.0, 1.0);
    return distribution(generator);
}

You have attempted of activities on this page.

🔗

Prev TopNext