Struct randomize::PCG32

pub struct PCG32 {
    pub state: u64,
    pub inc: u64,
}

A permuted congruential generator with 32-bit output. Pick this by default.

Fields

state: u64

State value. Changes with every use.

inc: u64

Inc value. Selects the output stream ordering.

This doesn't change as the generator is used. You just set it and forget it. If this value isn't odd, your generator won't have a full period before it loops. The seed constructor will ensure that the inc value is set to be odd, but the From constructors will not.

Methods

impl PCG32

pub const fn seed(seed: u64, inc: u64) -> Self

Crates a generator from the seed and inc given.

The precise seeding details are not considered a "stable" part of the API.

If you wish to exactly create a generator using particular state and inc values then use the From impl.

pub fn next_u32(&mut self) -> u32

Runs the generator once and gets a u32 as output.

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

Fill a mutable byte slice from this generator.

pub fn jump(&mut self, delta: u64)

Advances the generator delta steps in log(delta) time.

Trait Implementations

impl From<[u64; 2]> for PCG32

fn from(value: [u64; 2]) -> Self

Uses the provided values exactly.

impl From<(u64, u64)> for PCG32

fn from(value: (u64, u64)) -> Self

Uses the provided values exactly.

impl From<PCG32> for [u64; 2]

fn from(pcg: PCG32) -> Self

Performs the conversion.

impl From<PCG32> for (u64, u64)

fn from(pcg: PCG32) -> Self

Performs the conversion.

impl PartialEq<PCG32> for PCG32

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Eq for PCG32

impl Hash for PCG32

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl Debug for PCG32

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

Formats the value using the given formatter.

impl Clone for PCG32

fn clone(&self) -> PCG32

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for PCG32

fn default() -> Self

Returns the "default value" for a type.