Struct Seed 

pub struct Seed {
    pub bytes: [u8; 32],
}

A type representing a random seed.

Fields

bytes: [u8; 32]

Implementations

impl Seed

pub const fn from_bytes(bytes: [u8; 32]) -> Self

Creates a Seed from a slice of 32 bytes.

Worst-case complexity

Constant time and additional memory.

Examples

use malachite_base::random::Seed;

Seed::from_bytes([10; 32]);

pub fn get_rng(self) -> ChaCha20Rng

Creates a PRNG from a slice of 32 bytes.

Worst-case complexity

Constant time and additional memory.

Examples

use malachite_base::random::EXAMPLE_SEED;

EXAMPLE_SEED.get_rng();

pub fn next(self) -> Self

Uniformly generates a random Seed.

Worst-case complexity

Constant time and additional memory.

Examples

use malachite_base::random::{Seed, EXAMPLE_SEED};

assert_eq!(
    EXAMPLE_SEED.next(),
    Seed::from_bytes([
        0x71, 0xef, 0x45, 0x6c, 0xe4, 0xd2, 0xa8, 0xa1, 0x57, 0x20, 0x6e, 0x53, 0xbc, 0x22,
        0x59, 0xee, 0x5d, 0xc8, 0x95, 0x73, 0xbd, 0x95, 0xd9, 0xc9, 0x75, 0x92, 0x1f, 0x48,
        0x97, 0xa9, 0xae, 0x21
    ])
);

pub fn fork(&self, key: &str) -> Self

Generates a new Seed from this seed. Passing different keys will, with very high probability, generate different seeds.

Worst-case complexity

$T(n) = O(n)$

$M(n) = O(1)$

where $T$ is time, $M$ is additional memory, and $n$ is key.len().

Examples

use malachite_base::random::{Seed, EXAMPLE_SEED};

assert_eq!(
    EXAMPLE_SEED.fork("first"),
    Seed::from_bytes([
        0x20, 0x18, 0x1, 0x3d, 0x96, 0x4d, 0x3e, 0x98, 0x10, 0x9d, 0x35, 0x75, 0x22, 0x89,
        0xf7, 0xe9, 0xbe, 0x2f, 0x9c, 0x15, 0x95, 0x42, 0x1a, 0x79, 0x52, 0xf, 0x56, 0x9a,
        0x7b, 0x8c, 0xd9, 0x34
    ])
);
assert_eq!(
    EXAMPLE_SEED.fork("second"),
    Seed::from_bytes([
        0xe0, 0x36, 0x88, 0x58, 0x6d, 0x67, 0x33, 0xea, 0xf2, 0x1c, 0x88, 0xf9, 0xe3, 0xbd,
        0x52, 0xc0, 0xe5, 0xad, 0x61, 0x81, 0x21, 0xd8, 0x2f, 0x8e, 0xcd, 0xf, 0x89, 0x9d,
        0x32, 0xc5, 0x35, 0x83
    ])
);

Trait Implementations

impl Clone for Seed

fn clone(&self) -> Seed

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Seed

impl Debug for Seed

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

Formats the value using the given formatter.

impl Eq for Seed

impl Hash for Seed

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Seed

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Seed