c_random.hpp

#pragma once
#include <types.h>
 
/// @brief Random number generation helper class.
/// @ingroup clib
class cRandom_c {
public:
 
    /// @brief Initializes the class with the given seed.
    cRandom_c(u32 seed) : mSeed(seed) {}
 
    u32 getRandomByAsm(ulong max); ///< Generates an integer between 0 and the given max.
    float getRandomFByAsm(); ///< Generates a floating point number between 0 and 1.
    float getRandomF2ByAsm(); ///< Generates a floating point number between -0.5 and 0.5.
 
    u32 mSeed; ///< The current seed.
 
private:
    /// @brief Implementation of the @p ranqd1 algorithm.
    /// @bug The implementation is flawed.
    /// @xlink{https://roadrunnerwmc.github.io/blog/2020/05/08/nsmb-rng.html, This post explains why}.
    inline u32 ranqdStep();
};