pub struct Xoroshiro128StarStar { /* private fields */ }
Expand description
A xoroshiro128** random number generator.
The xoroshiro128** algorithm is not suitable for cryptographic purposes, but is very fast and has excellent statistical properties.
The algorithm used here is translated from the xoroshiro128starstar.c
reference source code by
David Blackman and Sebastiano Vigna.
Implementations§
Source§impl Xoroshiro128StarStar
impl Xoroshiro128StarStar
Sourcepub fn jump(&mut self)
pub fn jump(&mut self)
Jump forward, equivalently to 2^64 calls to next_u64()
.
This can be used to generate 2^64 non-overlapping subsequences for parallel computations.
use rand_xoshiro::rand_core::SeedableRng;
use rand_xoshiro::Xoroshiro128StarStar;
let rng1 = Xoroshiro128StarStar::seed_from_u64(0);
let mut rng2 = rng1.clone();
rng2.jump();
let mut rng3 = rng2.clone();
rng3.jump();
Trait Implementations§
Source§impl Clone for Xoroshiro128StarStar
impl Clone for Xoroshiro128StarStar
Source§fn clone(&self) -> Xoroshiro128StarStar
fn clone(&self) -> Xoroshiro128StarStar
Returns a copy of the value. Read more
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from
source
. Read moreSource§impl Debug for Xoroshiro128StarStar
impl Debug for Xoroshiro128StarStar
Source§impl PartialEq for Xoroshiro128StarStar
impl PartialEq for Xoroshiro128StarStar
Source§impl RngCore for Xoroshiro128StarStar
impl RngCore for Xoroshiro128StarStar
Source§impl SeedableRng for Xoroshiro128StarStar
impl SeedableRng for Xoroshiro128StarStar
Source§fn from_seed(seed: [u8; 16]) -> Xoroshiro128StarStar
fn from_seed(seed: [u8; 16]) -> Xoroshiro128StarStar
Create a new Xoroshiro128StarStar
. If seed
is entirely 0, it will be
mapped to a different seed.
Source§fn seed_from_u64(seed: u64) -> Xoroshiro128StarStar
fn seed_from_u64(seed: u64) -> Xoroshiro128StarStar
Seed a Xoroshiro128StarStar
from a u64
using SplitMix64
.
Source§type Seed = [u8; 16]
type Seed = [u8; 16]
Seed type, which is restricted to types mutably-dereferenceable as
u8
arrays (we recommend [u8; N]
for some N
). Read moreSource§fn from_rng(rng: &mut impl RngCore) -> Self
fn from_rng(rng: &mut impl RngCore) -> Self
Create a new PRNG seeded from an infallible
Rng
. Read moreSource§fn try_from_rng<R>(rng: &mut R) -> Result<Self, <R as TryRngCore>::Error>where
R: TryRngCore,
fn try_from_rng<R>(rng: &mut R) -> Result<Self, <R as TryRngCore>::Error>where
R: TryRngCore,
Create a new PRNG seeded from a potentially fallible
Rng
. Read moreSource§fn from_os_rng() -> Self
fn from_os_rng() -> Self
impl Eq for Xoroshiro128StarStar
impl StructuralPartialEq for Xoroshiro128StarStar
Auto Trait Implementations§
impl Freeze for Xoroshiro128StarStar
impl RefUnwindSafe for Xoroshiro128StarStar
impl Send for Xoroshiro128StarStar
impl Sync for Xoroshiro128StarStar
impl Unpin for Xoroshiro128StarStar
impl UnwindSafe for Xoroshiro128StarStar
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<R> TryRngCore for R
impl<R> TryRngCore for R
Source§type Error = Infallible
type Error = Infallible
The type returned in the event of a RNG error.
Source§fn try_next_u32(&mut self) -> Result<u32, <R as TryRngCore>::Error>
fn try_next_u32(&mut self) -> Result<u32, <R as TryRngCore>::Error>
Return the next random
u32
.Source§fn try_next_u64(&mut self) -> Result<u64, <R as TryRngCore>::Error>
fn try_next_u64(&mut self) -> Result<u64, <R as TryRngCore>::Error>
Return the next random
u64
.Source§fn try_fill_bytes(
&mut self,
dst: &mut [u8],
) -> Result<(), <R as TryRngCore>::Error>
fn try_fill_bytes( &mut self, dst: &mut [u8], ) -> Result<(), <R as TryRngCore>::Error>
Fill
dest
entirely with random data.Source§fn unwrap_mut(&mut self) -> UnwrapMut<'_, Self>
fn unwrap_mut(&mut self) -> UnwrapMut<'_, Self>
Wrap RNG with the
UnwrapMut
wrapper.Source§fn read_adapter(&mut self) -> RngReadAdapter<'_, Self>where
Self: Sized,
fn read_adapter(&mut self) -> RngReadAdapter<'_, Self>where
Self: Sized,
Convert an
RngCore
to a RngReadAdapter
.