[−][src]Struct rand::distributions::range::Range
Sample values uniformly between two bounds.
This gives a uniform distribution (assuming the RNG used to sample
it is itself uniform & the SampleRange
implementation for the
given type is correct), even for edge cases like low = 0u8
,
high = 170u8
, for which a naive modulo operation would return
numbers less than 85 with double the probability to those greater
than 85.
Types should attempt to sample in [low, high)
, i.e., not
including high
, but this may be very difficult. All the
primitive integer types satisfy this property, and the float types
normally satisfy it, but rounding may mean high
can occur.
Example
use rand::distributions::{IndependentSample, Range}; fn main() { let between = Range::new(10, 10000); let mut rng = rand::thread_rng(); let mut sum = 0; for _ in 0..1000 { sum += between.ind_sample(&mut rng); } println!("{}", sum); }
Methods
impl<X> Range<X> where
X: SampleRange + PartialOrd<X>,
[src]
[−]
impl<X> Range<X> where
X: SampleRange + PartialOrd<X>,
pub fn new(low: X, high: X) -> Range<X>
[src]
[−]
pub fn new(low: X, high: X) -> Range<X>
Create a new Range
instance that samples uniformly from
[low, high)
. Panics if low >= high
.
Trait Implementations
impl<X> Clone for Range<X> where
X: Clone,
[src]
[+]
impl<X> Clone for Range<X> where
X: Clone,
impl<X> Copy for Range<X> where
X: Copy,
[src]
impl<X> Copy for Range<X> where
X: Copy,
impl<Sup> IndependentSample<Sup> for Range<Sup> where
Sup: SampleRange,
[src]
[+]
impl<Sup> IndependentSample<Sup> for Range<Sup> where
Sup: SampleRange,
impl<X> Debug for Range<X> where
X: Debug,
[src]
[+]
impl<X> Debug for Range<X> where
X: Debug,
impl<Sup> Sample<Sup> for Range<Sup> where
Sup: SampleRange,
[src]
[+]
impl<Sup> Sample<Sup> for Range<Sup> where
Sup: SampleRange,
Auto Trait Implementations
Blanket Implementations
impl<T> From for T
[src]
[−]
impl<T> From for T
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, 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