Struct cap_rand::distributions::uniform::UniformFloat
source · [−]pub struct UniformFloat<X> { /* private fields */ }
Expand description
The back-end implementing UniformSampler
for floating-point types.
Unless you are implementing UniformSampler
for your own type, this type
should not be used directly, use Uniform
instead.
Implementation notes
Instead of generating a float in the [0, 1)
range using Standard
, the
UniformFloat
implementation converts the output of an PRNG itself. This
way one or two steps can be optimized out.
The floats are first converted to a value in the [1, 2)
interval using a
transmute-based method, and then mapped to the expected range with a
multiply and addition. Values produced this way have what equals 23 bits of
random digits for an f32
, and 52 for an f64
.
Trait Implementations
sourceimpl<X> Clone for UniformFloat<X> where
X: Clone,
impl<X> Clone for UniformFloat<X> where
X: Clone,
sourcefn clone(&self) -> UniformFloat<X>
fn clone(&self) -> UniformFloat<X>
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
sourceimpl<X> Debug for UniformFloat<X> where
X: Debug,
impl<X> Debug for UniformFloat<X> where
X: Debug,
sourceimpl<X> PartialEq<UniformFloat<X>> for UniformFloat<X> where
X: PartialEq<X>,
impl<X> PartialEq<UniformFloat<X>> for UniformFloat<X> where
X: PartialEq<X>,
sourcefn eq(&self, other: &UniformFloat<X>) -> bool
fn eq(&self, other: &UniformFloat<X>) -> bool
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
sourcefn ne(&self, other: &UniformFloat<X>) -> bool
fn ne(&self, other: &UniformFloat<X>) -> bool
This method tests for !=
.
sourceimpl UniformSampler for UniformFloat<f64>
impl UniformSampler for UniformFloat<f64>
sourcefn new<B1, B2>(low_b: B1, high_b: B2) -> UniformFloat<f64> where
B1: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,
fn new<B1, B2>(low_b: B1, high_b: B2) -> UniformFloat<f64> where
B1: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,
Construct self, with inclusive lower bound and exclusive upper bound
[low, high)
. Read more
sourcefn new_inclusive<B1, B2>(low_b: B1, high_b: B2) -> UniformFloat<f64> where
B1: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,
fn new_inclusive<B1, B2>(low_b: B1, high_b: B2) -> UniformFloat<f64> where
B1: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,
Construct self, with inclusive bounds [low, high]
. Read more
sourcefn sample<R>(&self, rng: &mut R) -> <UniformFloat<f64> as UniformSampler>::X where
R: Rng + ?Sized,
fn sample<R>(&self, rng: &mut R) -> <UniformFloat<f64> as UniformSampler>::X where
R: Rng + ?Sized,
Sample a value.
sourcefn sample_single<R, B1, B2>(
low_b: B1,
high_b: B2,
rng: &mut R
) -> <UniformFloat<f64> as UniformSampler>::X where
R: Rng + ?Sized,
B1: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,
fn sample_single<R, B1, B2>(
low_b: B1,
high_b: B2,
rng: &mut R
) -> <UniformFloat<f64> as UniformSampler>::X where
R: Rng + ?Sized,
B1: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,
Sample a single value uniformly from a range with inclusive lower bound
and exclusive upper bound [low, high)
. Read more
sourcefn sample_single_inclusive<R, B1, B2>(low: B1, high: B2, rng: &mut R) -> Self::X where
R: Rng + ?Sized,
B1: SampleBorrow<Self::X>,
B2: SampleBorrow<Self::X>,
fn sample_single_inclusive<R, B1, B2>(low: B1, high: B2, rng: &mut R) -> Self::X where
R: Rng + ?Sized,
B1: SampleBorrow<Self::X>,
B2: SampleBorrow<Self::X>,
Sample a single value uniformly from a range with inclusive lower bound
and inclusive upper bound [low, high]
. Read more
sourceimpl UniformSampler for UniformFloat<f32>
impl UniformSampler for UniformFloat<f32>
sourcefn new<B1, B2>(low_b: B1, high_b: B2) -> UniformFloat<f32> where
B1: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,
fn new<B1, B2>(low_b: B1, high_b: B2) -> UniformFloat<f32> where
B1: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,
Construct self, with inclusive lower bound and exclusive upper bound
[low, high)
. Read more
sourcefn new_inclusive<B1, B2>(low_b: B1, high_b: B2) -> UniformFloat<f32> where
B1: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,
fn new_inclusive<B1, B2>(low_b: B1, high_b: B2) -> UniformFloat<f32> where
B1: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,
Construct self, with inclusive bounds [low, high]
. Read more
sourcefn sample<R>(&self, rng: &mut R) -> <UniformFloat<f32> as UniformSampler>::X where
R: Rng + ?Sized,
fn sample<R>(&self, rng: &mut R) -> <UniformFloat<f32> as UniformSampler>::X where
R: Rng + ?Sized,
Sample a value.
sourcefn sample_single<R, B1, B2>(
low_b: B1,
high_b: B2,
rng: &mut R
) -> <UniformFloat<f32> as UniformSampler>::X where
R: Rng + ?Sized,
B1: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,
fn sample_single<R, B1, B2>(
low_b: B1,
high_b: B2,
rng: &mut R
) -> <UniformFloat<f32> as UniformSampler>::X where
R: Rng + ?Sized,
B1: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,
Sample a single value uniformly from a range with inclusive lower bound
and exclusive upper bound [low, high)
. Read more
sourcefn sample_single_inclusive<R, B1, B2>(low: B1, high: B2, rng: &mut R) -> Self::X where
R: Rng + ?Sized,
B1: SampleBorrow<Self::X>,
B2: SampleBorrow<Self::X>,
fn sample_single_inclusive<R, B1, B2>(low: B1, high: B2, rng: &mut R) -> Self::X where
R: Rng + ?Sized,
B1: SampleBorrow<Self::X>,
B2: SampleBorrow<Self::X>,
Sample a single value uniformly from a range with inclusive lower bound
and inclusive upper bound [low, high]
. Read more
impl<X> Copy for UniformFloat<X> where
X: Copy,
impl<X> StructuralPartialEq for UniformFloat<X>
Auto Trait Implementations
impl<X> RefUnwindSafe for UniformFloat<X> where
X: RefUnwindSafe,
impl<X> Send for UniformFloat<X> where
X: Send,
impl<X> Sync for UniformFloat<X> where
X: Sync,
impl<X> Unpin for UniformFloat<X> where
X: Unpin,
impl<X> UnwindSafe for UniformFloat<X> where
X: UnwindSafe,
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more