rand::sample - Rust
Description: API documentation for the Rust `sample` fn in crate `rand`.
Keywords: rust, rustlang, rust-lang, sample

# Function rand::sample [−] [src]

    pub fn sample<T, I, R>(rng: &mut R, iterable: I, amount: usize) -> Vec<T> where
        I: IntoIterator<Item = T>,
        R: Rng,

Randomly sample up to `amount` elements from a finite iterator. The order of elements in the sample is not random.

# Example

    use rand::{thread_rng, sample};

    let mut rng = thread_rng();
    let sample = sample(&mut rng, 1..100, 5);
    println!("{:?}", sample);

# Help

## Keyboard Shortcuts

?
  Show this help dialog
S
  Focus the search field
⇤
  Move up in search results
⇥
  Move down in search results
⏎
  Go to active search result
+
  Collapse/expand all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)