Struct SecureRng

pub struct SecureRng { /* private fields */ }

A cryptographically secure random number generator.

The current implementation is ChaCha with 8 rounds, as supplied by the rand_chacha crate.

Trait Implementations

impl Debug for SecureRng

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

Formats the value using the given formatter.

impl Drop for SecureRng

fn drop(&mut self)

Executes the destructor for this type.

impl Generator for SecureRng

fn try_new() -> Result<Self, Error>

Creates a generator using randomness provided by the OS.

fn u64(&mut self) -> u64

Returns a uniformly distributed u64 in the interval [0, 2⁶⁴).

fn new() -> Self

Creates a generator using randomness provided by the OS.

fn u32(&mut self) -> u32

Returns a uniformly distributed u32 in the interval [0, 2³²).

fn u16(&mut self) -> u16

Returns a uniformly distributed u16 in the interval [0, 2¹⁶).

fn u8(&mut self) -> u8

Returns a uniformly distributed u8 in the interval [0, 2⁸).

fn bits(&mut self, bit_count: u32) -> u64

Returns a uniformly distributed u64 in the interval [0, 2^bit_count).

fn bool(&mut self) -> bool

Returns a bool with 50% odds of being true.

fn bound(&mut self, bound: u64) -> u64

Returns a uniformly distributed u64 in the interval [0, bound).

fn bound_inclusive(&mut self, bound: u64) -> u64

Returns a uniformly distributed u64 in the interval [0, bound].

fn range(&mut self, start: i64, end: i64) -> i64

Returns a uniformly distributed i64 in the interval [start, end)

fn range_inclusive(&mut self, start: i64, end: i64) -> i64

Returns a uniformly distributed i64 in the interval [start, end]

fn f64(&mut self) -> f64

Returns a uniformly distributed f64 in the interval [0.0, 1.0).

fn f32(&mut self) -> f32

Returns a uniformly distributed f32 in the interval [0.0, 1.0).

fn f64_nonzero(&mut self) -> f64

Returns a uniformly distributed f64 in the interval (0.0, 1.0].

fn f32_nonzero(&mut self) -> f32

Returns a uniformly distributed f32 in the interval (0.0, 1.0].

fn f64_wide(&mut self) -> f64

Returns a uniformly distributed f64 in the interval (-1.0, 1.0).

fn f32_wide(&mut self) -> f32

Returns a uniformly distributed f32 in the interval (-1.0, 1.0).

fn f64_normal(&mut self) -> (f64, f64)

Returns two indepedent and normally distributed f64 values with mean = 0 and stddev = 1.

fn f64_normal_distribution(&mut self, mean: f64, stddev: f64) -> (f64, f64)

Returns two indepedent and normally distributed f64 values with user-defined mean and stddev.

fn f64_exponential(&mut self) -> f64

Returns an exponentially distributed f64 with lambda = 1.

fn f64_exponential_lambda(&mut self, lambda: f64) -> f64

Returns an exponentially distributed f64 with user-defined lambda.

fn choose<C>(&mut self, collection: C) -> Option<C::Item>

where C: IntoIterator, C::IntoIter: ExactSizeIterator,

Returns a randomly chosen item from the iterator of collection.

fn ascii_alphabetic(&mut self) -> char

Returns a randomly selected ASCII alphabetic character.

fn ascii_uppercase(&mut self) -> char

Returns a randomly selected ASCII uppercase character.

fn ascii_lowercase(&mut self) -> char

Returns a randomly selected ASCII lowercase character.

fn ascii_alphanumeric(&mut self) -> char

Returns a randomly selected ASCII alphanumeric character.

fn ascii_digit(&mut self) -> char

Returns a randomly selected ASCII digit character.

fn shuffle<T>(&mut self, slice: &mut [T])

Performs a Fisher-Yates shuffle on the contents of slice.

impl SecureGenerator for SecureRng

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

Fills dest with random data, which is safe to be used in cryptographic contexts.