Struct Sfc32 

pub struct Sfc32 { /* private fields */ }

A sfc32 random number generator.

The sfc32 algorithm is not suitable for cryptographic uses but is very fast. This algorithm has a 128-bit state and outputs 32-bit random numbers. The average period of this algorithm is approximately 2¹²⁷, and the minimum period is greater than or equal to 2³².

The algorithm used here is translated from the reference implementation provided by PractRand version pre0.95, which is licensed under the public domain.

Examples

let mut rng = Sfc32::from_seed([0; 12]);
assert_eq!(rng.next_u32(), 0xfb52_c520);

Implementations

impl Sfc32

pub fn new(a: u32, b: u32, c: u32, rounds: Option<u32>) -> Self

Creates a new Sfc32 using the given seeds.

If rounds is None, the state is mixed up 15 rounds during initialization.

Examples

let mut rng = Sfc32::new(0, 0, 0, None);
assert_eq!(rng.next_u32(), 0xfb52_c520);

pub fn new_u64(seed: u64, rounds: Option<u32>) -> Self

Creates a new Sfc32 using a u64 seed.

If rounds is None, the state is mixed up 12 rounds during initialization.

Note that the result of this method is different from the result of Sfc32::seed_from_u64.

Examples

let mut rng = Sfc32::new_u64(0, None);
assert_eq!(rng.next_u32(), 0x5146_76c3);

Trait Implementations

impl Clone for Sfc32

fn clone(&self) -> Sfc32

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Sfc32

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Sfc32

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Sfc32

fn eq(&self, other: &Sfc32) -> 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 RngCore for Sfc32

fn next_u32(&mut self) -> u32

Return the next random u32.

fn next_u64(&mut self) -> u64

Return the next random u64.

fn fill_bytes(&mut self, dst: &mut [u8])

Fill dest with random data.

impl SeedableRng for Sfc32

type Seed = [u8; 12]

Seed type, which is restricted to types mutably-dereferenceable as u8 arrays (we recommend [u8; N] for some N).

fn from_seed(seed: Self::Seed) -> Self

Create a new PRNG using the given seed.

fn seed_from_u64(state: u64) -> Self

Create a new PRNG using a u64 seed.

fn from_rng(rng: &mut impl RngCore) -> Self

Create a new PRNG seeded from an infallible Rng.

fn try_from_rng<R>(rng: &mut R) -> Result<Self, <R as TryRngCore>::Error>

where R: TryRngCore,

Create a new PRNG seeded from a potentially fallible Rng.

impl Serialize for Sfc32

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Sfc32

impl StructuralPartialEq for Sfc32