`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

`UniformFloat`

implementations convert RNG output to a float in the range
`[1, 2)`

via transmutation, map this to `[0, 1)`

, then scale and translate
to the desired range. Values produced this way have what equals 23 bits of
random digits for an `f32`

and 52 for an `f64`

.

## §Bias and range errors

Bias may be expected within the least-significant bit of the significand.
It is not guaranteed that exclusive limits of a range are respected; i.e.
when sampling the range `[a, b)`

it is not guaranteed that `b`

is never
sampled.

## Trait Implementations§

Source§### impl<X> Clone for UniformFloat<X>where
X: Clone,

### impl<X> Clone for UniformFloat<X>where
X: Clone,

Source§#### fn clone(&self) -> UniformFloat<X>

#### fn clone(&self) -> UniformFloat<X>

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<X> Debug for UniformFloat<X>where
X: Debug,

### impl<X> Debug for UniformFloat<X>where
X: Debug,

Source§### impl<'de, X> Deserialize<'de> for UniformFloat<X>where
X: Deserialize<'de>,

### impl<'de, X> Deserialize<'de> for UniformFloat<X>where
X: Deserialize<'de>,

Source§#### fn deserialize<__D>(
__deserializer: __D,
) -> Result<UniformFloat<X>, <__D as Deserializer<'de>>::Error>where
__D: Deserializer<'de>,

#### fn deserialize<__D>(
__deserializer: __D,
) -> Result<UniformFloat<X>, <__D as Deserializer<'de>>::Error>where
__D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more

Source§### impl<X> PartialEq for UniformFloat<X>where
X: PartialEq,

### impl<X> PartialEq for UniformFloat<X>where
X: PartialEq,

Source§### impl<X> Serialize for UniformFloat<X>where
X: Serialize,

### impl<X> Serialize for UniformFloat<X>where
X: Serialize,

Source§#### fn serialize<__S>(
&self,
__serializer: __S,
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where
__S: Serializer,

#### fn serialize<__S>(
&self,
__serializer: __S,
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where
__S: Serializer,

Serialize this value into the given Serde serializer. Read more

Source§### impl UniformSampler for UniformFloat<f32>

### impl UniformSampler for UniformFloat<f32>

Source§#### fn new<B1, B2>(low_b: B1, high_b: B2) -> Result<UniformFloat<f32>, Error>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) -> Result<UniformFloat<f32>, Error>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 moreSource§#### fn new_inclusive<B1, B2>(
low_b: B1,
high_b: B2,
) -> Result<UniformFloat<f32>, Error>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,
) -> Result<UniformFloat<f32>, Error>where
B1: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,

Construct self, with inclusive bounds

`[low, high]`

. Read moreSource§#### fn sample<R>(&self, rng: &mut R) -> <UniformFloat<f32> as UniformSampler>::X

#### fn sample<R>(&self, rng: &mut R) -> <UniformFloat<f32> as UniformSampler>::X

Sample a value.

Source§#### fn sample_single<R, B1, B2>(
low_b: B1,
high_b: B2,
rng: &mut R,
) -> Result<<UniformFloat<f32> as UniformSampler>::X, Error>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,
) -> Result<<UniformFloat<f32> as UniformSampler>::X, Error>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 moreSource§#### fn sample_single_inclusive<R, B1, B2>(
low_b: B1,
high_b: B2,
rng: &mut R,
) -> Result<<UniformFloat<f32> as UniformSampler>::X, Error>where
R: Rng + ?Sized,
B1: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f32> as UniformSampler>::X>,

#### fn sample_single_inclusive<R, B1, B2>(
low_b: B1,
high_b: B2,
rng: &mut R,
) -> Result<<UniformFloat<f32> as UniformSampler>::X, Error>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 inclusive upper bound

`[low, high]`

. Read moreSource§### impl UniformSampler for UniformFloat<f64>

### impl UniformSampler for UniformFloat<f64>

Source§#### fn new<B1, B2>(low_b: B1, high_b: B2) -> Result<UniformFloat<f64>, Error>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) -> Result<UniformFloat<f64>, Error>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 moreSource§#### fn new_inclusive<B1, B2>(
low_b: B1,
high_b: B2,
) -> Result<UniformFloat<f64>, Error>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,
) -> Result<UniformFloat<f64>, Error>where
B1: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,

Construct self, with inclusive bounds

`[low, high]`

. Read moreSource§#### fn sample<R>(&self, rng: &mut R) -> <UniformFloat<f64> as UniformSampler>::X

#### fn sample<R>(&self, rng: &mut R) -> <UniformFloat<f64> as UniformSampler>::X

Sample a value.

Source§#### fn sample_single<R, B1, B2>(
low_b: B1,
high_b: B2,
rng: &mut R,
) -> Result<<UniformFloat<f64> as UniformSampler>::X, Error>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,
) -> Result<<UniformFloat<f64> as UniformSampler>::X, Error>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 moreSource§#### fn sample_single_inclusive<R, B1, B2>(
low_b: B1,
high_b: B2,
rng: &mut R,
) -> Result<<UniformFloat<f64> as UniformSampler>::X, Error>where
R: Rng + ?Sized,
B1: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,
B2: SampleBorrow<<UniformFloat<f64> as UniformSampler>::X>,

#### fn sample_single_inclusive<R, B1, B2>(
low_b: B1,
high_b: B2,
rng: &mut R,
) -> Result<<UniformFloat<f64> as UniformSampler>::X, Error>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 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> Freeze for UniformFloat<X>where
X: Freeze,

### 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§

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§#### unsafe fn clone_to_uninit(&self, dst: *mut T)

#### unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (

`clone_to_uninit`

)