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
sourceimpl Rng for OsRng
impl Rng for OsRng
sourcefn fill_bytes(&mut self, v: &mut [u8])
fn fill_bytes(&mut self, v: &mut [u8])
Fill
dest
with random data. Read moresourcefn 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 moresourcefn 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 moresourcefn gen<T: Rand>(&mut self) -> Twhere
Self: Sized,
fn gen<T: Rand>(&mut self) -> Twhere
Self: Sized,
Return a random value of a
Rand
type. Read moresourcefn gen_iter<'a, T: Rand>(&'a mut self) -> Generator<'a, T, Self> ⓘwhere
Self: Sized,
fn gen_iter<'a, T: Rand>(&'a mut self) -> Generator<'a, T, Self> ⓘwhere
Self: Sized,
Return an iterator that will yield an infinite number of randomly
generated items. Read more
sourcefn gen_range<T: PartialOrd + SampleRange>(&mut self, low: T, high: T) -> Twhere
Self: Sized,
fn gen_range<T: PartialOrd + SampleRange>(&mut self, low: T, high: T) -> Twhere
Self: Sized,
sourcefn 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
sourcefn 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
sourcefn choose<'a, T>(&mut self, values: &'a [T]) -> Option<&'a T>where
Self: Sized,
fn choose<'a, T>(&mut self, values: &'a [T]) -> Option<&'a T>where
Self: Sized,
Return a random element from
values
. Read moreAuto Trait Implementations
impl RefUnwindSafe for OsRng
impl Send for OsRng
impl Sync for OsRng
impl Unpin for OsRng
impl UnwindSafe for OsRng
Blanket Implementations
sourceimpl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more