/*** 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(Memory::MemoryViewWrite view) = 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 inline void NextFillArray(T(&array)[N]) { Read(Memory::MemoryViewWrite(array)); } template inline void NextFillArray(T *pArray, AuUInt32 uCount) { Read(Memory::MemoryViewWrite(pArray, uCount * sizeof(T))); } template void NextFillRange(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 inline T NextFillTmpl() { T ret {}; Read(Memory::MemoryViewWrite(&ret, sizeof(T))); return ret; } template inline T &NextIterator(T &begin, T &end) { return begin + NextIndex(AuUInt(end - begin)); } template inline T &NextArray(T *pItems, AuUInt32 uCount) { return pItems[NextIndex(uCount)]; } template inline T &NextVector(AuList &items) { return NextArray(items.data(), items.size()); } template inline T &NextRange(T &items) { return NextIterator(items.begin(), items.end()); } }; AUKN_SHARED_API(Random, IRandomDevice, const RandomDef &def); }