Function malachite_q::random::striped_random_nonzero_rationals
source · pub fn striped_random_nonzero_rationals(
seed: Seed,
mean_stripe_numerator: u64,
mean_stripe_denominator: u64,
mean_bits_numerator: u64,
mean_bits_denominator: u64
) -> RandomRationalsFromSingleAndSign<StripedRandomNaturals<GeometricRandomNaturalValues<u64>>> ⓘ
Expand description
Generates striped random nonzero Rational
s with a specified mean numerator and denominator
bit length.
The output length is infinite.
See StripedBitSource
for information
about generating striped random numbers.
§Expected complexity per iteration
$T(n) = O(n (\log n)^2 \log\log n)$
$M(n) = O(n \log n)$
where $T$ is time, $M$ is additional memory, and $n$ is mean_bits_numerator / mean_bits_denominator
.
§Panics
Panics if mean_stripe_denominator
is zero, if mean_stripe_numerator < mean_stripe_denominator
, if mean_bits_numerator
or mean_bits_denominator
are zero, or if
mean_bits_numerator <= mean_bits_denominator
.
§Examples
use malachite_base::iterators::prefix_to_string;
use malachite_base::random::EXAMPLE_SEED;
use malachite_q::random::striped_random_nonzero_rationals;
assert_eq!(
prefix_to_string(
striped_random_nonzero_rationals(EXAMPLE_SEED, 16, 1, 32, 1),
10
),
"[-68720000000/18006083452797439, -2545165805/29, 549754781664/1236950581247, \
1065353727/2047, -2147745791/513, 16128/575, 8192/17000482516899619632318463, \
18431/16778240, 1/31, 4096/526335, ...]"
)