RandX::Xoroshiro64StarStar类 参考

Xoroshiro64** 伪随机数生成器，32 位输出，周期 2^64-1。 更多...

#include <RandX.hpp>

类 RandX::Xoroshiro64StarStar 继承关系图:

RandX::Xoroshiro64StarStar 的协作图:

Public 类型
using	result_type
using	state_type
	< 输出类型
Public 类型 继承自 RandX::detail::EngineBase< Xoroshiro64StarStar, std::uint32_t, 2 >
using	result_type
using	state_type

Public 成员函数
constexpr	Xoroshiro64StarStar () noexcept
	< 状态类型（2×uint32）
constexpr	Xoroshiro64StarStar (std::uint64_t seed) noexcept
	以指定种子构造引擎
template<class SeedSeq> requires (!std::same_as<std::remove_cvref_t<SeedSeq>, Xoroshiro64StarStar>)
constexpr	Xoroshiro64StarStar (SeedSeq &seq)
	从 std::seed_seq 播种
constexpr	Xoroshiro64StarStar (state_type state) noexcept
	从状态数组直接构造
constexpr result_type	operator() () noexcept
	生成下一个 32 位随机数
constexpr	Xoroshiro64StarStar () noexcept
	< 状态类型（2×uint32）
RANDX_NODISCARD_CXX20 constexpr	Xoroshiro64StarStar (std::uint64_t seed) noexcept
	以指定种子构造引擎
template<class SeedSeq, std::enable_if_t<!std::is_same_v< std::decay_t< SeedSeq >, Xoroshiro64StarStar > > * = nullptr>
RANDX_NODISCARD_CXX20 constexpr	Xoroshiro64StarStar (SeedSeq &seq)
	从 std::seed_seq 播种
RANDX_NODISCARD_CXX20 constexpr	Xoroshiro64StarStar (state_type state) noexcept
	从状态数组直接构造
constexpr result_type	operator() () noexcept
	生成下一个 32 位随机数
Public 成员函数 继承自 RandX::detail::EngineBase< Xoroshiro64StarStar, std::uint32_t, 2 >
constexpr void	discard (unsigned long long z) noexcept
constexpr state_type	serialize () const noexcept
constexpr void	deserialize (const state_type &s) noexcept
constexpr void	discard (unsigned long long z) noexcept
constexpr state_type	serialize () const noexcept
constexpr void	deserialize (const state_type &s) noexcept

额外继承的成员函数
静态 Public 成员函数 继承自 RandX::detail::EngineBase< Xoroshiro64StarStar, std::uint32_t, 2 >
static constexpr result_type	min () noexcept
static constexpr result_type	max () noexcept
static constexpr result_type	min () noexcept
static constexpr result_type	max () noexcept
Protected 成员函数 继承自 RandX::detail::EngineBase< Xoroshiro64StarStar, std::uint32_t, 2 >
	EngineBase ()=default
constexpr	EngineBase (const state_type &state) noexcept
constexpr	EngineBase (SeedSeq &seq)
constexpr	EngineBase (std::uint64_t seed) noexcept
constexpr void	jumpPoly (const std::uint32_t(&poly)[K]) noexcept
	EngineBase ()=default
constexpr	EngineBase (const state_type &state) noexcept
constexpr	EngineBase (SeedSeq &seq)
constexpr	EngineBase (std::uint64_t seed) noexcept
constexpr void	jumpPoly (const std::uint32_t(&poly)[K]) noexcept
Protected 属性 继承自 RandX::detail::EngineBase< Xoroshiro64StarStar, std::uint32_t, 2 >
state_type	s_
静态 Protected 属性 继承自 RandX::detail::EngineBase< Xoroshiro64StarStar, std::uint32_t, 2 >
static constexpr int	Bits

详细描述

Xoroshiro64** 伪随机数生成器，32 位输出，周期 2^64-1。

状态 8 字节（2×uint32），适合极端内存受限场景。 满足 std::uniform_random_bit_generator 概念。 原始实现：http://prng.di.unimi.it/xoroshiro64starstar.c

注解

无 jump 方法。非 CSPRNG，不可用于密码学场景。安全场景请使用 ChaCha20。

参见

Xoshiro128StarStar, Xoroshiro128StarStar, ChaCha20

成员类型定义说明

result_type

using RandX::detail::EngineBase< Xoroshiro64StarStar, std::uint32_t, N >::result_type

state_type

using RandX::detail::EngineBase< Xoroshiro64StarStar, std::uint32_t, N >::state_type

< 输出类型

构造及析构函数说明

Xoroshiro64StarStar() [1/4]

RandX::Xoroshiro64StarStar::Xoroshiro64StarStar ( )

inlineconstexprnoexcept

< 状态类型（2×uint32）

默认构造（使用 DefaultSeed）

Xoroshiro64StarStar() [2/4]

RANDX_NODISCARD_CXX20 constexpr RandX::Xoroshiro64StarStar::Xoroshiro64StarStar ( std::uint64_t seed )

inlineexplicitconstexprnoexcept

以指定种子构造引擎

参数

seed

64 位种子值

Xoroshiro64StarStar() [3/4]

template<class SeedSeq, std::enable_if_t<!std::is_same_v< std::decay_t< SeedSeq >, Xoroshiro64StarStar > > * = nullptr>

RANDX_NODISCARD_CXX20 constexpr RandX::Xoroshiro64StarStar::Xoroshiro64StarStar ( SeedSeq & seq )

inlineexplicitconstexpr

从 std::seed_seq 播种

参数

seq

种子序列对象

Xoroshiro64StarStar() [4/4]

RANDX_NODISCARD_CXX20 constexpr RandX::Xoroshiro64StarStar::Xoroshiro64StarStar ( state_type state )

inlineexplicitconstexprnoexcept

从状态数组直接构造

参数

state

serialize() 返回的状态

成员函数说明

operator()()

result_type RandX::Xoroshiro64StarStar::operator() ( )

constexprnoexcept

生成下一个 32 位随机数

返回

[min(), max()] 区间内的伪随机数

函数调用图:

---

该类的文档由以下文件生成:

• RandX.hpp
• RandX_Cpp17.hpp