[−][src]Struct proptest::test_runner::TestRng
Proptest's random number generator.
Methods
impl TestRng
[src]
impl TestRng
pub fn from_seed(algorithm: RngAlgorithm, seed: &[u8]) -> Self
[src]
pub fn from_seed(algorithm: RngAlgorithm, seed: &[u8]) -> Self
Create a new RNG with the given algorithm and seed.
Any RNG created with the same algorithm-seed pair will produce the same sequence of values on all systems and all supporting versions of proptest.
Panics
Panics if seed
is not an appropriate length for algorithm
.
pub fn deterministic_rng(algorithm: RngAlgorithm) -> Self
[src]
pub fn deterministic_rng(algorithm: RngAlgorithm) -> Self
Returns a TestRng
with a particular hard-coded seed.
The seed value will always be the same for a particular version of Proptest and algorithm, but may change across releases.
This is useful for testing things like strategy implementations without
risking getting "unlucky" RNGs which deviate from average behaviour
enough to cause spurious failures. For example, a strategy for bool
which is supposed to produce true
50% of the time might have a test
which checks that the distribution is "close enough" to 50%. If every
test run starts with a different RNG, occasionally there will be
spurious test failures when the RNG happens to produce a very skewed
distribution. Using this or TestRunner::deterministic()
avoids such
issues.
Trait Implementations
impl Debug for TestRng
[src]
impl Debug for TestRng
impl Clone for TestRng
[src]
impl Clone for TestRng
fn clone(&self) -> TestRng
[src]
fn clone(&self) -> TestRng
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 RngCore for TestRng
[src]
impl RngCore for TestRng
Auto Trait Implementations
Blanket Implementations
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>
impl<T> From for T
[src]
impl<T> From for T
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>
impl<T, U> Into for T where
U: From<T>,
[src]
impl<T, U> Into for T where
U: From<T>,
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
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
impl<T> ToOwned for T where
T: Clone,
[src]
impl<T> ToOwned for T where
T: Clone,
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>(&mut self, low: T, high: T) -> T where
T: SampleUniform + PartialOrd<T>,
[src]
fn gen_range<T>(&mut self, low: T, high: T) -> T where
T: SampleUniform + PartialOrd<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>(&mut self, distr: D) -> T where
D: Distribution<T>,
[src]
fn sample<T, D>(&mut self, distr: D) -> T where
D: Distribution<T>,
Sample a new value, using the given distribution. Read more
fn sample_iter<T, D>(&'a mut self, distr: &'a D) -> DistIter<'a, D, Self, T> where
D: Distribution<T>,
[src]
fn sample_iter<T, D>(&'a mut self, distr: &'a D) -> DistIter<'a, D, Self, T> where
D: Distribution<T>,
Create an iterator that generates values using the given distribution. Read more
fn fill<T>(&mut self, dest: &mut T) where
T: AsByteSliceMut + ?Sized,
[src]
fn fill<T>(&mut self, dest: &mut T) where
T: AsByteSliceMut + ?Sized,
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>(&mut self, dest: &mut T) -> Result<(), Error> where
T: AsByteSliceMut + ?Sized,
[src]
fn try_fill<T>(&mut self, dest: &mut T) -> Result<(), Error> where
T: AsByteSliceMut + ?Sized,
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<T>(&mut self, values: &'a [T]) -> Option<&'a T>
[src]
fn choose<T>(&mut self, values: &'a [T]) -> Option<&'a T>
Return a random element from values
. Read more
fn choose_mut<T>(&mut self, values: &'a mut [T]) -> Option<&'a mut T>
[src]
fn choose_mut<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
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
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> 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, B1, B2>(&mut self, low: B1, high: B2) -> T where
B1: SampleBorrow<T>,
B2: SampleBorrow<T>,
T: SampleUniform,
[src]
fn gen_range<T, B1, B2>(&mut self, low: B1, high: B2) -> T where
B1: SampleBorrow<T>,
B2: SampleBorrow<T>,
T: SampleUniform,
Generate a random value in the range [low
, high
), i.e. inclusive of low
and exclusive of high
. Read more
fn sample<T, D>(&mut self, distr: D) -> T where
D: Distribution<T>,
[src]
fn sample<T, D>(&mut self, distr: D) -> T where
D: Distribution<T>,
Sample a new value, using the given distribution. Read more
fn sample_iter<T, D>(&'a mut self, distr: &'a D) -> DistIter<'a, D, Self, T> where
D: Distribution<T>,
[src]
fn sample_iter<T, D>(&'a mut self, distr: &'a D) -> DistIter<'a, D, Self, T> where
D: Distribution<T>,
Create an iterator that generates values using the given distribution. Read more
fn fill<T>(&mut self, dest: &mut T) where
T: AsByteSliceMut + ?Sized,
[src]
fn fill<T>(&mut self, dest: &mut T) where
T: AsByteSliceMut + ?Sized,
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>(&mut self, dest: &mut T) -> Result<(), Error> where
T: AsByteSliceMut + ?Sized,
[src]
fn try_fill<T>(&mut self, dest: &mut T) -> Result<(), Error> where
T: AsByteSliceMut + ?Sized,
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 gen_ratio(&mut self, numerator: u32, denominator: u32) -> bool
[src]
fn gen_ratio(&mut self, numerator: u32, denominator: u32) -> bool
Return a bool with a probability of numerator/denominator
of being true. I.e. gen_ratio(2, 3)
has chance of 2 in 3, or about 67%, of returning true. If numerator == denominator
, then the returned value is guaranteed to be true
. If numerator == 0
, then the returned value is guaranteed to be false
. Read more
fn choose<T>(&mut self, values: &'a [T]) -> Option<&'a T>
[src]
fn choose<T>(&mut self, values: &'a [T]) -> Option<&'a T>
: use SliceRandom::choose instead
Return a random element from values
. Read more
fn choose_mut<T>(&mut self, values: &'a mut [T]) -> Option<&'a mut T>
[src]
fn choose_mut<T>(&mut self, values: &'a mut [T]) -> Option<&'a mut T>
: use SliceRandom::choose_mut instead
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])
: use SliceRandom::shuffle instead
Shuffle a mutable slice in place. Read more