Class random

src/fl/math/random.h:25–103

@brief A random number generator class that wraps FastLED's random functions This class provides a standard C++ random generator interface that can be used with algorithms like fl::shuffle. Each instance maintains its own seed state independent of other instances and the global FastLED random state. All public methods delegate to private _nolock helpers. This means external locking (via the Lock

/// fl::shuffle(vec.begin(), vec.end(), rng);
/// @endcode
class random {
public:
    typedef u32 result_type;

    /// Default constructor - uses current global random seed
    random() FL_NOEXCEPT : mSeed(random16_get_seed()) {}

    /// Constructor with explicit seed
    explicit random(u16 seed) FL_NOEXCEPT : mSeed(seed) {}

    result_type operator()() FL_NOEXCEPT { return generate_nolock(); }
    result_type operator()(result_type n) FL_NOEXCEPT { return generate_nolock(n); }
    result_type operator()(result_type min, result_type max) FL_NOEXCEPT { return generate_nolock(min, max); }

    void set_seed(u16 seed) FL_NOEXCEPT { mSeed = seed; }
    u16 get_seed() const FL_NOEXCEPT { return mSeed; }
    void add_entropy(u16 entropy) FL_NOEXCEPT { mSeed += entropy; }

    static constexpr result_type minimum() FL_NOEXCEPT { return 0; }
    static constexpr result_type maximum() FL_NOEXCEPT { return 4294967295U; }

    u8 random8() FL_NOEXCEPT { return random8_nolock(); }
    u8 random8(u8 n) FL_NOEXCEPT { return random8_nolock(n); }
    u8 random8(u8 min, u8 max) FL_NOEXCEPT { return random8_nolock(min, max); }

    u16 random16() FL_NOEXCEPT { return random16_nolock(); }
    u16 random16(u16 n) FL_NOEXCEPT { return static_cast<u16>(generate_nolock(n)); }
    u16 random16(u16 min, u16 max) FL_NOEXCEPT { return static_cast<u16>(generate_nolock(min, max)); }

private:
    u16 mSeed;

    u16 next_random16_nolock() FL_NOEXCEPT {
        mSeed = APPLY_FASTLED_RAND16_2053(mSeed) + FASTLED_RAND16_13849;
        return mSeed;
    }

    u32 next_random32_nolock() FL_NOEXCEPT {
        u32 high = next_random16_nolock();
        u32 low = next_random16_nolock();
        return (high << 16) | low;
    }

    result_type generate_nolock() FL_NOEXCEPT {
        return next_random32_nolock();
    }

    result_type generate_nolock(result_type n) FL_NOEXCEPT {
        if (n == 0) return 0;
        u32 r = next_random32_nolock();
        fl::u64 p = (fl::u64)n * (fl::u64)r;
        return (u32)(p >> 32);
    }

    result_type generate_nolock(result_type min, result_type max) FL_NOEXCEPT {
        result_type delta = max - min;
        return generate_nolock(delta) + min;
    }