Struct SysRng 

pub struct SysRng;

Available on crate feature getrandom only.

A TryRngCore interface over the system’s preferred random number source

This is a zero-sized struct. It can be freely constructed with just SysRng.

This struct is also available as rand::rngs::SysRng when using rand.

Usage example

SysRng implements TryRngCore:

use getrandom::{rand_core::TryRngCore, SysRng};

let mut key = [0u8; 32];
SysRng.try_fill_bytes(&mut key).unwrap();

Using it as an RngCore is possible using TryRngCore::unwrap_err:

use getrandom::rand_core::{TryRngCore, RngCore};
use getrandom::SysRng;

let mut rng = SysRng.unwrap_err();
let random_u64 = rng.next_u64();

Trait Implementations

impl Clone for SysRng

fn clone(&self) -> SysRng

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SysRng

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

Formats the value using the given formatter.

impl Default for SysRng

fn default() -> SysRng

Returns the “default value” for a type.

impl TryRngCore for SysRng

type Error = Error

The type returned in the event of a RNG error.

fn try_next_u32(&mut self) -> Result<u32, Error>

Return the next random u32.

fn try_next_u64(&mut self) -> Result<u64, Error>

Return the next random u64.

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

Fill dest entirely with random data.

fn unwrap_err(self) -> UnwrapErr<Self>

where Self: Sized,

Wrap RNG with the UnwrapErr wrapper.

fn unwrap_mut(&mut self) -> UnwrapMut<'_, Self>

Wrap RNG with the UnwrapMut wrapper.

impl Copy for SysRng

impl TryCryptoRng for SysRng