Struct rand::rngs::OsRng

source · [−]

pub struct OsRng;

Expand description

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

-

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

-

The implementation is provided by the getrandom crate. Refer to -getrandom documentation for details.

-

This struct is only available when specifying the crate feature getrandom -or std. When using the rand lib, it is also available as rand::rngs::OsRng.

-

Blocking and error handling

-

It is possible that when used during early boot the first call to OsRng -will block until the system’s RNG is initialised. It is also possible -(though highly unlikely) for OsRng to fail on some platforms, most -likely due to system mis-configuration.

-

After the first successful call, it is highly unlikely that failures or -significant delays will occur (although performance should be expected to -be much slower than a user-space PRNG).

-

Usage example

-

use rand_core::{RngCore, OsRng};
-
-let mut key = [0u8; 16];
-OsRng.fill_bytes(&mut key);
-let random_u64 = OsRng.next_u64();

-

Struct rand::rngs::OsRng

Blocking and error handling

Usage example

Trait Implementations

impl Clone for OsRng

fn clone(&self) -> OsRng

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

impl Debug for OsRng

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

impl Default for OsRng

fn default() -> OsRng

impl RngCore for OsRng

fn next_u32(&mut self) -> u32

fn next_u64(&mut self) -> u64

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

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

impl Copy for OsRng

impl CryptoRng for OsRng

Auto Trait Implementations

impl RefUnwindSafe for OsRng

impl Send for OsRng

impl Sync for OsRng

impl Unpin for OsRng

impl UnwindSafe for OsRng

Blanket Implementations

impl<T> Any for Twhere T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for Twhere T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for Twhere T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> CryptoRngCore for Twhere T: CryptoRng + RngCore,

fn as_rngcore(&mut self) -> &mut dyn RngCoreⓘNotable traits for dyn RngCore + 'staticimpl Read for dyn RngCore + 'static

impl<T> From<T> for T

fn from(t: T) -> T

impl<T, U> Into<U> for Twhere U: From<T>,

fn into(self) -> U

impl<T> ToOwned for Twhere T: Clone,

type Owned = T

fn to_owned(&self) -> T

fn clone_into(&self, target: &mut T)

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

type Error = Infallible

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<V, T> VZip<V> for Twhere V: MultiLane<T>,

fn vzip(self) -> V

impl<T> Any for Twhere
T: 'static + ?Sized,

impl<T> Borrow<T> for Twhere
T: ?Sized,

impl<T> BorrowMut<T> for Twhere
T: ?Sized,

impl<T> CryptoRngCore for Twhere
T: CryptoRng + RngCore,

fn as_rngcore(&mut self) -> &mut dyn RngCoreⓘNotable traits for dyn RngCore + 'static`impl Read for dyn RngCore + 'static`

impl<T, U> Into<U> for Twhere
U: From<T>,

impl<T> ToOwned for Twhere
T: Clone,

impl<T, U> TryFrom<U> for Twhere
U: Into<T>,

impl<T, U> TryInto<U> for Twhere
U: TryFrom<T>,

impl<V, T> VZip<V> for Twhere
V: MultiLane<T>,