[−][src]Struct rand::prng::XorShiftRng
An Xorshift random number generator.
The Xorshift1 algorithm is not suitable for cryptographic purposes
but is very fast. If you do not know for sure that it fits your
requirements, use a more secure one such as IsaacRng
or OsRng
.
-
Marsaglia, George (July 2003). "Xorshift RNGs". Journal of Statistical Software. Vol. 8 (Issue 14). ↩
Methods
impl XorShiftRng
[src]
impl XorShiftRng
pub fn new_unseeded() -> XorShiftRng
[src]
pub fn new_unseeded() -> XorShiftRng
: use the FromEntropy or SeedableRng trait
Creates a new XorShiftRng instance which is not seeded.
The initial values of this RNG are constants, so all generators created
by this function will yield the same stream of random numbers. It is
highly recommended that this is created through SeedableRng
instead of
this function
Trait Implementations
impl Clone for XorShiftRng
[src]
impl Clone for XorShiftRng
fn clone(&self) -> XorShiftRng
[src]
fn clone(&self) -> XorShiftRng
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0[src]
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
impl Debug for XorShiftRng
[src]
impl Debug for XorShiftRng
fn fmt(&self, f: &mut Formatter) -> Result
[src]
fn fmt(&self, f: &mut Formatter) -> Result
Formats the value using the given formatter. Read more
impl SeedableRng for XorShiftRng
[src]
impl SeedableRng for XorShiftRng
type Seed = [u8; 16]
Seed type, which is restricted to types mutably-dereferencable as u8
arrays (we recommend [u8; N]
for some N
). Read more
fn from_seed(seed: Self::Seed) -> Self
[src]
fn from_seed(seed: Self::Seed) -> Self
Create a new PRNG using the given seed. Read more
fn from_rng<R: RngCore>(rng: R) -> Result<Self, Error>
[src]
fn from_rng<R: RngCore>(rng: R) -> Result<Self, Error>
Create a new PRNG seeded from another Rng
. Read more
fn seed_from_u64(state: u64) -> Self
[src]
fn seed_from_u64(state: u64) -> Self
Create a new PRNG using a u64
seed. Read more
impl RngCore for XorShiftRng
[src]
impl RngCore for XorShiftRng
fn next_u32(&mut self) -> u32
[src]
fn next_u32(&mut self) -> u32
Return the next random u32
. Read more
fn next_u64(&mut self) -> u64
[src]
fn next_u64(&mut self) -> u64
Return the next random u64
. Read more
fn fill_bytes(&mut self, dest: &mut [u8])
[src]
fn fill_bytes(&mut self, dest: &mut [u8])
Fill dest
with random data. Read more
fn try_fill_bytes(&mut self, dest: &mut [u8]) -> Result<(), Error>
[src]
fn try_fill_bytes(&mut self, dest: &mut [u8]) -> Result<(), Error>
Fill dest
entirely with random data. Read more
Auto Trait Implementations
impl Send for XorShiftRng
impl Send for XorShiftRng
impl Sync for XorShiftRng
impl Sync for XorShiftRng
Blanket Implementations
impl<R> Rng for R where
R: RngCore + ?Sized,
[src]
impl<R> Rng for R where
R: RngCore + ?Sized,
fn gen<T>(&mut self) -> T where
Standard: Distribution<T>,
[src]
fn gen<T>(&mut self) -> T where
Standard: Distribution<T>,
Return a random value supporting the [Standard
] distribution. Read more
fn gen_range<T: PartialOrd + SampleUniform>(&mut self, low: T, high: T) -> T
[src]
fn gen_range<T: PartialOrd + SampleUniform>(&mut self, low: T, high: T) -> T
Generate a random value in the range [low
, high
), i.e. inclusive of low
and exclusive of high
. Read more
fn sample<T, D: Distribution<T>>(&mut self, distr: D) -> T
[src]
fn sample<T, D: Distribution<T>>(&mut self, distr: D) -> T
Sample a new value, using the given distribution. Read more
ⓘImportant traits for DistIter<'a, D, R, T>fn sample_iter<'a, T, D: Distribution<T>>(
&'a mut self,
distr: &'a D
) -> DistIter<'a, D, Self, T> where
Self: Sized,
[src]
fn sample_iter<'a, T, D: Distribution<T>>(
&'a mut self,
distr: &'a D
) -> DistIter<'a, D, Self, T> where
Self: Sized,
Create an iterator that generates values using the given distribution. Read more
fn fill<T: AsByteSliceMut + ?Sized>(&mut self, dest: &mut T)
[src]
fn fill<T: AsByteSliceMut + ?Sized>(&mut self, dest: &mut T)
Fill dest
entirely with random bytes (uniform value distribution), where dest
is any type supporting [AsByteSliceMut
], namely slices and arrays over primitive integer types (i8
, i16
, u32
, etc.). Read more
fn try_fill<T: AsByteSliceMut + ?Sized>(
&mut self,
dest: &mut T
) -> Result<(), Error>
[src]
fn try_fill<T: AsByteSliceMut + ?Sized>(
&mut self,
dest: &mut T
) -> Result<(), Error>
Fill dest
entirely with random bytes (uniform value distribution), where dest
is any type supporting [AsByteSliceMut
], namely slices and arrays over primitive integer types (i8
, i16
, u32
, etc.). Read more
fn gen_bool(&mut self, p: f64) -> bool
[src]
fn gen_bool(&mut self, p: f64) -> bool
Return a bool with a probability p
of being true. Read more
fn choose<'a, T>(&mut self, values: &'a [T]) -> Option<&'a T>
[src]
fn choose<'a, T>(&mut self, values: &'a [T]) -> Option<&'a T>
Return a random element from values
. Read more
fn choose_mut<'a, T>(&mut self, values: &'a mut [T]) -> Option<&'a mut T>
[src]
fn choose_mut<'a, T>(&mut self, values: &'a mut [T]) -> Option<&'a mut T>
Return a mutable pointer to a random element from values
. Read more
fn shuffle<T>(&mut self, values: &mut [T])
[src]
fn shuffle<T>(&mut self, values: &mut [T])
Shuffle a mutable slice in place. Read more
ⓘImportant traits for Generator<T, R>fn gen_iter<T>(&mut self) -> Generator<T, &mut Self> where
Standard: Distribution<T>,
[src]
fn gen_iter<T>(&mut self) -> Generator<T, &mut Self> where
Standard: Distribution<T>,
: use Rng::sample_iter(&Standard) instead
Return an iterator that will yield an infinite number of randomly generated items. Read more
fn gen_weighted_bool(&mut self, n: u32) -> bool
[src]
fn gen_weighted_bool(&mut self, n: u32) -> bool
: use gen_bool instead
Return a bool with a 1 in n chance of true Read more
ⓘImportant traits for AsciiGenerator<R>fn gen_ascii_chars(&mut self) -> AsciiGenerator<&mut Self>
[src]
fn gen_ascii_chars(&mut self) -> AsciiGenerator<&mut Self>
: use sample_iter(&Alphanumeric) instead
Return an iterator of random characters from the set A-Z,a-z,0-9. Read more
impl<R> FromEntropy for R where
R: SeedableRng,
[src]
impl<R> FromEntropy for R where
R: SeedableRng,
fn from_entropy() -> R
[src]
fn from_entropy() -> R
Creates a new instance, automatically seeded with fresh entropy. Read more
impl<T, U> Into for T where
U: From<T>,
[src]
impl<T, U> Into for T where
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
impl<T> ToOwned for T where
T: Clone,
type Owned = T
fn to_owned(&self) -> T
[src]
fn to_owned(&self) -> T
Creates owned data from borrowed data, usually by cloning. Read more
fn clone_into(&self, target: &mut T)
[src]
fn clone_into(&self, target: &mut T)
🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more
impl<T> From for T
[src]
impl<T> From for T
impl<T, U> TryFrom for T where
T: From<U>,
[src]
impl<T, U> TryFrom for T where
T: From<U>,
type Error = !
try_from
)The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
try_from
)Performs the conversion.
impl<T> Borrow for T where
T: ?Sized,
[src]
impl<T> Borrow for T where
T: ?Sized,
impl<T> BorrowMut for T where
T: ?Sized,
[src]
impl<T> BorrowMut for T where
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
impl<T, U> TryInto for T where
U: TryFrom<T>,
[src]
impl<T, U> TryInto for T where
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
try_from
)The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
try_from
)Performs the conversion.
impl<T> Any for T where
T: 'static + ?Sized,
[src]
impl<T> Any for T where
T: 'static + ?Sized,
fn get_type_id(&self) -> TypeId
[src]
fn get_type_id(&self) -> TypeId
🔬 This is a nightly-only experimental API. (get_type_id
)
this method will likely be replaced by an associated static
Gets the TypeId
of self
. Read more