Struct rand::os::OsRng

pub struct OsRng(_);

A random number generator that retrieves randomness straight from the operating system.

Platform sources:

• Unix-like systems (Linux, Android, Mac OSX): read directly from /dev/urandom, or from getrandom(2) system call if available.
• OpenBSD: calls getentropy(2)
• FreeBSD: uses the kern.arandom sysctl(2) mib
• Windows: calls RtlGenRandom, exported from advapi32.dll as SystemFunction036.
• iOS: calls SecRandomCopyBytes as /dev/(u)random is sandboxed.

This usually does not block. On some systems (e.g. FreeBSD, OpenBSD, Max OS X, and modern Linux) this may block very early in the init process, if the CSPRNG has not been seeded yet.[1]

[1] See https://www.python.org/dev/peps/pep-0524/ for a more in-depth discussion.

Methods

impl OsRng

pub fn new() -> Result<OsRng, Error>

Create a new OsRng.

Trait Implementations

impl Debug for OsRng

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

Formats the value using the given formatter.

impl Rng for OsRng

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, v: &mut [u8]) -> Result<(), Error>

Fill dest entirely with random data.

fn next_f32(&mut self) -> f32

Return the next random f32 selected from the half-open interval [0, 1).

fn next_f64(&mut self) -> f64

Return the next random f64 selected from the half-open interval [0, 1).