AuroraRuntime/Include/Aurora/RNG/IRandomDevice.hpp

  /***
    Copyright (C) 2021 J Reece Wilson (a/k/a "Reece"). All rights reserved.

    File: IRandomDevice.hpp
    Date: 2021-9-3
    Author: Reece
***/
#pragma once 

namespace Aurora::RNG
{
    struct IRandomDevice
    {
        virtual void     Read(void *pIn, AuUInt32 uLength) = 0;
        
        virtual AuString NextString(AuUInt32 uLength, ERngStringCharacters type = ERngStringCharacters::eAlphaCharacters) = 0;
        virtual void     NextString(char *pString, AuUInt32 uLength, ERngStringCharacters type = ERngStringCharacters::eAlphaCharacters) = 0;
        virtual AuUInt8  NextByte() = 0;
        virtual bool     NextBoolean() = 0;
        virtual AuUInt32 NextU32() = 0;
        virtual AuUInt32 NextU32(AuUInt32 uMin, AuUInt32 uMax) = 0;
        virtual AuUInt64 NextU64() = 0;
        virtual AuInt32  NextInt(AuInt32 uMin, AuInt32 uMax) = 0;
        virtual double   NextDecimal() = 0;
        virtual float    NextNumber(float min, float max) = 0;
        virtual AuUInt32 NextIndex(AuUInt32 uCount /* = max + 1*/) = 0;

        virtual Memory::MemoryViewRead ToSeed() = 0;
    
        template<typename T, int N>
        inline void NextFillArray(T(&array)[N])
        {
            Read(array, N * sizeof(T));
        }

        template<typename T>
        inline void NextFillArray(T *array, AuUInt32 length)
        {
            Read(array, length * sizeof(T));
        }

        template<typename T>
        void NextFillRange(const T &container)
        {
            NextFillArray(container.begin(), container.end() - container.begin());
        }

        inline void NextFillBuffer(Memory::ByteBuffer &buffer)
        {
            auto view = buffer.GetNextLinearWrite();
            NextFillRange(view);
            buffer.writePtr += view.length;
        }

        /**
         * @brief
         * @deprecated
        */
        inline void NextFillRange(Memory::ByteBuffer &buffer)
        {
            NextFillBuffer(buffer);
        }
    
        template<typename T>
        inline T NextFillTmpl()
        {
            T ret {};
            Read(&ret, sizeof(T));
            return ret;
        }

        template<typename T>
        inline T &NextIterator(T &begin, T &end)
        {
            return begin + NextIndex(AuUInt(end - begin));
        }

        template<typename T>
        inline T &NextArray(T *items, AuUInt32 count)
        {
            return items[NextIndex(count)];
        }
    
        template<typename T>
        inline T &NextVector(const AuList<T> &items)
        {
            return NextArray(items.data(), items.size());
        }

        template<typename T>
        inline T &NextRange(const T &items)
        {
            return NextIterator(items.begin(), items.end());
        }
    };

    AUKN_SHARED_API(Random, IRandomDevice, const RandomDef &def);
}