RandX 1.4.3
基于 xoshiro/xoroshiro 算法族的纯头文件伪随机数生成器库
载入中...
搜索中...
未找到
RandX::Xoroshiro128StarStar类 参考
引擎

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

#include <RandX.hpp>

类 RandX::Xoroshiro128StarStar 继承关系图:
Inheritance graph
[图例]
RandX::Xoroshiro128StarStar 的协作图:
Collaboration graph
[图例]

Public 类型

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

Public 成员函数

constexpr Xoroshiro128StarStar () noexcept
 < 状态类型（2×uint64）
constexpr Xoroshiro128StarStar (std::uint64_t seed) noexcept
 以指定种子构造引擎
template<class SeedSeq>
requires (!std::same_as<std::remove_cvref_t<SeedSeq>, Xoroshiro128StarStar>)
constexpr Xoroshiro128StarStar (SeedSeq &seq)
 从 std::seed_seq 播种
constexpr Xoroshiro128StarStar (state_type state) noexcept
 从状态数组直接构造
constexpr result_type operator() () noexcept
 生成下一个 64 位随机数
constexpr void jump () noexcept
 前进 2^64 步，用于创建并行子序列
constexpr void longJump () noexcept
 前进 2^96 步，用于创建更稀疏的并行子序列
constexpr Xoroshiro128StarStar () noexcept
 < 状态类型（2×uint64）
RANDX_NODISCARD_CXX20 constexpr Xoroshiro128StarStar (std::uint64_t seed) noexcept
 以指定种子构造引擎
template<class SeedSeq, std::enable_if_t<!std::is_same_v< std::decay_t< SeedSeq >, Xoroshiro128StarStar > > * = nullptr>
RANDX_NODISCARD_CXX20 constexpr Xoroshiro128StarStar (SeedSeq &seq)
 从 std::seed_seq 播种
RANDX_NODISCARD_CXX20 constexpr Xoroshiro128StarStar (state_type state) noexcept
 从状态数组直接构造
constexpr result_type operator() () noexcept
 生成下一个 64 位随机数
constexpr void jump () noexcept
 前进 2^64 步，用于创建并行子序列
constexpr void longJump () noexcept
 前进 2^96 步，用于创建更稀疏的并行子序列
Public 成员函数 继承自 RandX::detail::EngineBase< Xoroshiro128StarStar, std::uint64_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< Xoroshiro128StarStar, std::uint64_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< Xoroshiro128StarStar, std::uint64_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::uint64_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::uint64_t(&poly)[K]) noexcept
Protected 属性 继承自 RandX::detail::EngineBase< Xoroshiro128StarStar, std::uint64_t, 2 >
state_type s_
静态 Protected 属性 继承自 RandX::detail::EngineBase< Xoroshiro128StarStar, std::uint64_t, 2 >
static constexpr int Bits

详细描述

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

状态 16 字节（2×uint64），内存占用更小，统计质量更优， 适合内存受限场景。满足 std::uniform_random_bit_generator 概念。 原始实现：http://prng.di.unimi.it/xoroshiro128starstar.c（版本 1.0）

注解
非 CSPRNG，不可用于密码学场景。安全场景请使用 ChaCha20。
参见
Xoshiro256StarStar, Xoroshiro64StarStar, ChaCha20

成员类型定义说明

◆ result_type

using RandX::detail::EngineBase< Xoroshiro128StarStar, std::uint64_t, N >::result_type

◆ state_type

using RandX::detail::EngineBase< Xoroshiro128StarStar, std::uint64_t, N >::state_type

< 输出类型

构造及析构函数说明

◆ Xoroshiro128StarStar() [1/4]

RandX::Xoroshiro128StarStar::Xoroshiro128StarStar ( )
inlineconstexprnoexcept

< 状态类型（2×uint64）

默认构造（使用 DefaultSeed）

◆ Xoroshiro128StarStar() [2/4]

RANDX_NODISCARD_CXX20 constexpr RandX::Xoroshiro128StarStar::Xoroshiro128StarStar ( std::uint64_t seed)
inlineexplicitconstexprnoexcept

以指定种子构造引擎

参数
seed64 位种子值

◆ Xoroshiro128StarStar() [3/4]

template<class SeedSeq, std::enable_if_t<!std::is_same_v< std::decay_t< SeedSeq >, Xoroshiro128StarStar > > * = nullptr>
RANDX_NODISCARD_CXX20 constexpr RandX::Xoroshiro128StarStar::Xoroshiro128StarStar ( SeedSeq & seq)
inlineexplicitconstexpr

从 std::seed_seq 播种

参数
seq种子序列对象

◆ Xoroshiro128StarStar() [4/4]

RANDX_NODISCARD_CXX20 constexpr RandX::Xoroshiro128StarStar::Xoroshiro128StarStar ( state_type state)
inlineexplicitconstexprnoexcept

从状态数组直接构造

参数
stateserialize() 返回的状态

成员函数说明

◆ jump()

void RandX::Xoroshiro128StarStar::jump ( )
constexprnoexcept

前进 2^64 步，用于创建并行子序列

注解
等价于调用 2^64 次 operator()
参见
longJump(), MakeStreamEngine()
函数调用图:

◆ longJump()

void RandX::Xoroshiro128StarStar::longJump ( )
constexprnoexcept

前进 2^96 步，用于创建更稀疏的并行子序列

注解
等价于调用 2^96 次 operator()
参见
jump(), MakeStreamEngine()
函数调用图:

◆ operator()()

result_type RandX::Xoroshiro128StarStar::operator() ( )
constexprnoexcept

生成下一个 64 位随机数

返回
[min(), max()] 区间内的伪随机数
该类的文档由以下文件生成: