Struct Sfc64 

pub struct Sfc64 { /* private fields */ }

A sfc64 random number generator.

The sfc64 algorithm is not suitable for cryptographic uses but is very fast. This algorithm has a 256-bit state and outputs 64-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 = Sfc64::from_seed([0; 24]);
assert_eq!(rng.next_u64(), 0xdb90_9c81_8901_599d);

Implementations

impl Sfc64

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

Creates a new Sfc64 using the given seeds.

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

Examples

let mut rng = Sfc64::new(0, 0, 0, None);
assert_eq!(rng.next_u64(), 0xdb90_9c81_8901_599d);

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

Creates a new Sfc64 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 Sfc64::seed_from_u64.

Examples

let mut rng = Sfc64::new_u64(0, None);
assert_eq!(rng.next_u64(), 0x3acf_a029_e3cc_6041);

Trait Implementations

impl Clone for Sfc64

fn clone(&self) -> Sfc64

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Sfc64

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Sfc64

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Sfc64

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

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 Sfc64

type Seed = [u8; 24]

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 Sfc64

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 Sfc64

impl StructuralPartialEq for Sfc64