/*** Copyright (C) 2021 J Reece Wilson (a/k/a "Reece"). All rights reserved. File: RNG.hpp Date: 2021-7-14 Author: Reece ***/ #pragma once #include "ERngStringCharacters.hpp" #include "RandomDef.hpp" #include "IRandomDevice.hpp" namespace Aurora::RNG { AUKN_SYM void ReadSecureRNG(Memory::MemoryViewWrite writeView); AUKN_SYM void ReadFastRNG (Memory::MemoryViewWrite writeView); AUKN_SYM AuString ReadString(AuUInt32 uLength, ERngStringCharacters type = ERngStringCharacters::eAlphaCharacters); AUKN_SYM void RngString(char *pString, AuUInt32 uLength, ERngStringCharacters type = ERngStringCharacters::eAlphaCharacters); AUKN_SYM AuUInt8 RngByte(); AUKN_SYM bool RngBoolean(); AUKN_SYM AuUInt32 RngU32(); AUKN_SYM AuUInt32 RngU32(AuUInt32 uMin, AuUInt32 uMax); AUKN_SYM AuUInt64 RngU64(); AUKN_SYM AuInt32 RngInt(AuInt32 uMin, AuInt32 uMax); AUKN_SYM double RngDecimal(); AUKN_SYM float RngNumber(float min, float max); AUKN_SYM AuUInt32 RngIndex(AuUInt32 count /* = max + 1*/); // Note: it is conceivable that someone may want the following templates for some cryptographic purpose template static auline void RngFillArray(T(&array)[N]) { if constexpr (fast) { ReadFastRNG(Memory::MemoryViewWrite(array)); } else { ReadSecureRNG(Memory::MemoryViewWrite(array)); } } template static auline void RngFillArray(T *array, AuUInt32 uCount) { if constexpr (fast) { ReadFastRNG(Memory::MemoryViewWrite(array, uCount * sizeof(T))); } else { ReadSecureRNG(Memory::MemoryViewWrite(array, uCount * sizeof(T))); } } template static auline void RngFillRange(T &container) { RngFillArray(container.begin(), container.end() - container.begin()); } static auline void RngFillBuffer(Memory::ByteBuffer &buffer) { auto view = buffer.GetNextLinearWrite(); RngFillRange(view); buffer.writePtr += view.length; } /** * @brief * @deprecated */ static auline void RngFillRange(Memory::ByteBuffer &buffer) { RngFillBuffer(buffer); } template static auline T RngTmpl() { T ret {}; if constexpr (fast) { ReadFastRNG(Memory::MemoryViewWrite(&ret, sizeof(T))); } else { ReadSecureRNG(Memory::MemoryViewWrite(&ret, sizeof(T))); } return ret; } template static auline T &RngArray(T *pItems, AuUInt32 uCount) { return pItems[RngIndex(uCount)]; } template static auline T &RngVector(AuList &items) { return RngArray(items.data(), items.size()); } template static auline T &RngRange(T &items) { return RngArray(items.begin(), items.end() - items.begin()); } }