AuroraRuntime/Include/Aurora/RNG/RNG.hpp

115 lines
3.1 KiB
C++

/***
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<bool fast = true, typename T, int N>
static auline void RngFillArray(T(&array)[N])
{
if constexpr (fast)
{
ReadFastRNG(Memory::MemoryViewWrite(array));
}
else
{
ReadSecureRNG(Memory::MemoryViewWrite(array));
}
}
template<bool fast = true, typename T>
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<bool fast = true, typename T>
static auline void RngFillRange(T &container)
{
RngFillArray<fast>(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<bool fast = true, typename T>
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<typename T>
static auline T &RngArray(T *pItems, AuUInt32 uCount)
{
return pItems[RngIndex(uCount)];
}
template<typename T>
static auline T &RngVector(AuList<T> &items)
{
return RngArray(items.data(), items.size());
}
template<typename T>
static auline T &RngRange(T &items)
{
return RngArray(items.begin(), items.end() - items.begin());
}
}