pub struct OsRng(_);
Expand description
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 fromgetrandom(2)
system call if available. - OpenBSD: calls
getentropy(2)
- FreeBSD: uses the
kern.arandom
sysctl(2)
mib - Windows: calls
RtlGenRandom
, exported fromadvapi32.dll
asSystemFunction036
. - iOS: calls SecRandomCopyBytes as /dev/(u)random is sandboxed.
- PNaCl: calls into the
nacl-irt-random-0.1
IRT interface.
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.
Implementations§
Trait Implementations§
source§impl Rng for OsRng
impl Rng for OsRng
source§fn fill_bytes(&mut self, v: &mut [u8])
fn fill_bytes(&mut self, v: &mut [u8])
Fill
dest
with random data. Read moresource§fn next_f32(&mut self) -> f32
fn next_f32(&mut self) -> f32
Return the next random f32 selected from the half-open
interval
[0, 1)
. Read moresource§fn next_f64(&mut self) -> f64
fn next_f64(&mut self) -> f64
Return the next random f64 selected from the half-open
interval
[0, 1)
. Read moresource§fn gen<T>(&mut self) -> Twhere
T: Rand,
Self: Sized,
fn gen<T>(&mut self) -> Twhere
T: Rand,
Self: Sized,
Return a random value of a
Rand
type. Read moresource§fn gen_iter<T, 'a>(&'a mut self) -> Generator<'a, T, Self> ⓘwhere
T: Rand,
Self: Sized,
fn gen_iter<T, 'a>(&'a mut self) -> Generator<'a, T, Self> ⓘwhere
T: Rand,
Self: Sized,
Return an iterator that will yield an infinite number of randomly
generated items. Read more
source§fn gen_range<T>(&mut self, low: T, high: T) -> Twhere
T: PartialOrd<T> + SampleRange,
Self: Sized,
fn gen_range<T>(&mut self, low: T, high: T) -> Twhere
T: PartialOrd<T> + SampleRange,
Self: Sized,
source§fn gen_weighted_bool(&mut self, n: u32) -> boolwhere
Self: Sized,
fn gen_weighted_bool(&mut self, n: u32) -> boolwhere
Self: Sized,
Return a bool with a 1 in n chance of true Read more
source§fn gen_ascii_chars<'a>(&'a mut self) -> AsciiGenerator<'a, Self> ⓘwhere
Self: Sized,
fn gen_ascii_chars<'a>(&'a mut self) -> AsciiGenerator<'a, Self> ⓘwhere
Self: Sized,
Return an iterator of random characters from the set A-Z,a-z,0-9. Read more
source§fn choose<T, 'a>(&mut self, values: &'a [T]) -> Option<&'a T>where
Self: Sized,
fn choose<T, 'a>(&mut self, values: &'a [T]) -> Option<&'a T>where
Self: Sized,
Return a random element from
values
. Read more