Struct riot_wrappers::random::Random

pub struct Random(/* private fields */);

Available on riot_module_random only.

The global random number generator available in RIOT

Actual functionality is available through its implementation of rand_core_06::RngCore. It implements rand_core_06::CryptoRng if the RIOT module prng_shaxprng is present. (If more CSPRNGs are implemented in RIOT, the list around this implementation needs to be extended).

Note that this is copy (unlike what RngCore recommends) – because the state is not in here but global (as is their own OsRng).

Implementations

impl Random

pub fn new() -> Self

Available on riot_module_auto_init_random only.

Access the system random number generator

pub unsafe fn new_with_seed(seed: u32) -> Self

Seed and start the random number generator

While technically not unsound, this is marked unsafe as it may overwrite existing good RNG state.

This is not going through the the rand_core_06::SeedableRng trait because that would require per-RNG seedability.

Trait Implementations

impl Clone for Random

fn clone(&self) -> Random

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Random

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

Formats the value using the given formatter.

impl Default for Random

Available on riot_module_auto_init_random only.

fn default() -> Self

Returns the “default value” for a type.

impl RngCore for Random

fn next_u32(&mut self) -> u32

Return the next random u32.

fn next_u64(&mut self) -> u64

Return the next random u64.

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

Fill dest with random data.

fn try_fill_bytes(&mut self, dest: &mut [u8]) -> Result<(), Error>

Fill dest entirely with random data.

impl Copy for Random