Enum RngBackend 

#[non_exhaustive]
pub enum RngBackend {
    Xoshiro256PlusPlus(Xoshiro256PlusPlus),
    MersenneTwister(Box<MersenneTwister>),
    Pcg32(Pcg32),
    Pcg64(Pcg64),
    ChaCha20(Box<ChaChaRng>),
}

Available backends for Random.

Xoshiro is inline (no allocation) so it works on pure no_std. MT is only available with the alloc feature because its 2496-byte state is stored on the heap to keep the enum size small.

Examples

use vrd::RngBackend;
use vrd::xoshiro::Xoshiro256PlusPlus;

let backend = RngBackend::Xoshiro256PlusPlus(Xoshiro256PlusPlus::from_u64_seed(42));

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Xoshiro256PlusPlus(Xoshiro256PlusPlus)

Xoshiro256++ - fast, small-state, statistically strong. Default backend produced by Random::new.

Examples

use vrd::{Random, RngBackend};

let rng = Random::from_u64_seed(1);
assert!(matches!(rng.backend(), RngBackend::Xoshiro256PlusPlus(_)));

MersenneTwister(Box<MersenneTwister>)

Mersenne Twister (MT19937) - for callers needing legacy reproducibility. Requires the alloc feature; produced by Random::new_mersenne_twister_with_seed.

Examples

use vrd::{Random, RngBackend};

let rng = Random::new_mersenne_twister_with_seed(1);
assert!(matches!(rng.backend(), RngBackend::MersenneTwister(_)));

Pcg32(Pcg32)

PCG-XSH-RR-64/32 - 16-byte state, 32-bit output. Available under the pcg feature.

Pcg64(Pcg64)

PCG-XSL-RR-128/64 - 32-byte state, 64-bit output. Available under the pcg feature.

ChaCha20(Box<ChaChaRng>)

ChaCha20 CSPRNG - crypto-quality output. Produced by Random::new_secure / Random::from_secure_seed. Available under the crypto feature.

Trait Implementations

impl Clone for RngBackend

fn clone(&self) -> RngBackend

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RngBackend

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RngBackend

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RngBackend

fn eq(&self, other: &RngBackend) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for RngBackend

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RngBackend