Struct malachite_base::random::Seed

source · [−]

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

Expand description

A type representing a random seed.

Fields

bytes: [u8; 32]

Implementations

source

impl Seed

source

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

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]);

source

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();

source

pub fn next(self) -> Seed

Uniformly generates a random Seed.

Worst-case complexity

Constant time and additional memory.

Examples

use malachite_base::random::Seed;
use malachite_base::random::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
    ])
);

source

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

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

Worst-case complexity

Constant time and additional memory.

Examples

use malachite_base::random::Seed;
use malachite_base::random::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

source

impl Clone for Seed

source

fn clone(&self) -> Seed

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

source

impl Debug for Seed

source

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

Formats the value using the given formatter. Read more

source

impl Hash for Seed

source

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

Feeds this value into the given Hasher. Read more

1.3.0 · source

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

Feeds a slice of this type into the given Hasher. Read more

source

impl PartialEq<Seed> for Seed

source

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

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

source

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

This method tests for !=.

source

impl StructuralPartialEq for Seed

Auto Trait Implementations

impl RefUnwindSafe for Seed

impl Send for Seed

impl Sync for Seed

impl Unpin for Seed

impl UnwindSafe for Seed

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T, U> CheckedInto for T where
U: CheckedFrom<T>,

source

fn checked_into(self) -> Option

source

impl<T, U> ExactInto for T where
U: ExactFrom<T>,

source

fn exact_into(self) -> U

source

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source

impl<T, U> OverflowingInto for T where
U: OverflowingFrom<T>,

source

fn overflowing_into(self) -> (U, bool )

source

impl<T, U> RoundingInto for T where
U: RoundingFrom<T>,

source

fn rounding_into(self, rm: RoundingMode) -> U

source

impl<T> Same<T> for T

type Output = T

Should always be Self

source

impl<T, U> SaturatingInto for T where
U: SaturatingFrom<T>,

source

fn saturating_into(self) -> U

source

impl<T> ToDebugString for T where
T: Debug,

source

fn to_debug_string(&self) -> String

Returns the String produced by Ts Debug implementation.

Examples

use malachite_base::strings::ToDebugString;

assert_eq!([1, 2, 3].to_debug_string(), "[1, 2, 3]");
assert_eq!(
    [vec![2, 3], vec![], vec![4]].to_debug_string(),
    "[[2, 3], [], [4]]"
);
assert_eq!(Some(5).to_debug_string(), "Some(5)");

source

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

source

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

source

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

impl<V, T> VZip<V> for T where
V: MultiLane<T>,

fn vzip(self) -> V

source

impl<T, U> WrappingInto for T where
U: WrappingFrom<T>,

source

Struct malachite_base::random::Seed

Fields

Implementations

impl Seed

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

pub fn get_rng(self) -> ChaCha20Rng

pub fn next(self) -> Seed

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

Trait Implementations

impl Clone for Seed

fn clone(&self) -> Seed

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

impl Debug for Seed

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

impl Hash for Seed

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

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

impl PartialEq<Seed> for Seed

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

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

impl Copy for Seed

impl Eq for Seed

impl StructuralEq for Seed

impl StructuralPartialEq for Seed

Auto Trait Implementations

impl RefUnwindSafe for Seed

impl Send for Seed

impl Sync for Seed

impl Unpin for Seed

impl UnwindSafe for Seed

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T, U> CheckedInto<U> for T where U: CheckedFrom<T>,

fn checked_into(self) -> Option<U>

impl<T, U> ExactInto<U> for T where U: ExactFrom<T>,

fn exact_into(self) -> U

impl<T> From<T> for T

fn from(t: T) -> T

impl<T, U> Into<U> for T where U: From<T>,

fn into(self) -> U

impl<T, U> OverflowingInto<U> for T where U: OverflowingFrom<T>,

fn overflowing_into(self) -> (U, bool)

impl<T, U> RoundingInto<U> for T where U: RoundingFrom<T>,

fn rounding_into(self, rm: RoundingMode) -> U

impl<T> Same<T> for T

type Output = T

impl<T, U> SaturatingInto<U> for T where U: SaturatingFrom<T>,

fn saturating_into(self) -> U

impl<T> ToDebugString for T where T: Debug,

fn to_debug_string(&self) -> String

impl<T> ToOwned for T where T: Clone,

type Owned = T

fn to_owned(&self) -> T

fn clone_into(&self, target: &mut T)

impl<T, U> TryFrom<U> for T where U: Into<T>,

type Error = Infallible

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<V, T> VZip<V> for T where V: MultiLane<T>,

fn vzip(self) -> V

impl<T, U> WrappingInto<U> for T where U: WrappingFrom<T>,

fn wrapping_into(self) -> U

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

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

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

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T, U> CheckedInto<U> for T where
U: CheckedFrom<T>,

impl<T, U> ExactInto<U> for T where
U: ExactFrom<T>,

impl<T, U> Into<U> for T where
U: From<T>,

impl<T, U> OverflowingInto<U> for T where
U: OverflowingFrom<T>,

fn overflowing_into(self) -> (U, bool )

impl<T, U> RoundingInto<U> for T where
U: RoundingFrom<T>,

impl<T, U> SaturatingInto<U> for T where
U: SaturatingFrom<T>,

impl<T> ToDebugString for T where
T: Debug,

impl<T> ToOwned for T where
T: Clone,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

impl<V, T> VZip<V> for T where
V: MultiLane<T>,

impl<T, U> WrappingInto<U> for T where
U: WrappingFrom<T>,