Struct ChaCha

pub struct ChaCha<const ROUNDS: u8> { /* private fields */ }

An instance of the ChaCha random number generator. Seeded from the system entropy generator when available. This generator is theoretically cryptographically secure.

Implementations

impl<const ROUNDS: u8> ChaCha<ROUNDS>

pub fn new() -> Self

Create a new ChaCha instance, seeding from the system’s default source of entropy.

pub const fn new_key(key: [u8; 32], nonce: [u8; 8]) -> Self

Create a new ChaCha instance, using the provided key and nonce.

Trait Implementations

impl<const ROUNDS: u8> Clone for ChaCha<ROUNDS>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<const ROUNDS: u8> Debug for ChaCha<ROUNDS>

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

Formats the value using the given formatter.

impl<const ROUNDS: u8> Default for ChaCha<ROUNDS>

fn default() -> Self

Returns the “default value” for a type.

impl<const ROUNDS: u8> Display for ChaCha<ROUNDS>

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

Formats the value using the given formatter.

impl<const ROUNDS: u8> Rng<64> for ChaCha<ROUNDS>

fn rand(&mut self) -> [u8; 64]

Generates a random sequence of bytes, seeding from the internal state.

fn generate<Generated>(&mut self) -> Generated

where Generated: RandomGen<Self, OUTPUT>,

Generates a random of the specified type, seeding from the internal state.

fn fill_bytes<Bytes>(&mut self, buffer: Bytes)

where Bytes: AsMut<[u8]>,

Fill an array of bytes with randomness.

fn fill<Contents, Array>(&mut self, target: Array)

where Contents: RandomGen<Self, OUTPUT>, Array: AsMut<[Contents]>,

Fill an array with the specified type.

fn generate_range<Number, Bounds>(&mut self, range: Bounds) -> Number

where Number: RandomRange<Self, OUTPUT>, Bounds: RangeBounds<Number>,

Generates a random of the specified type, seeding from the internal state.

fn shuffle<Contents, Array>(&mut self, target: Array)

where Array: AsMut<[Contents]>,

Shuffle a slice, using the RNG.

impl<const ROUNDS: u8> SeedableRng<40, 64> for ChaCha<ROUNDS>

fn reseed(&mut self, seed: [u8; 40])

Re-seed the RNG with the specified bytes.