A Rust library for random number generators and other randomness functionality.

Documentation

Add this to your Cargo.toml:

[dependencies]
rand = "0.3"

and this to your crate root:

extern crate rand;

There is built-in support for a random number generator (RNG) associated with each thread stored in thread-local storage. This RNG can be accessed via thread_rng.

use rand::thread_rng;

let x: u32 = thread_rng().next_u32();
println!("{}", x)

use rand::distributions::{uniform};
use rand::Rng;

let mut rng = rand::thread_rng();
if uniform(&mut rng) { // random bool
    let x: i32 = uniform(&mut rng);
    let y: u32 = uniform(&mut rng);
    println!("i32: {}, u32: {}", x, y);
}

It is also possible to use other generators types, which have a similar interface. The following uses the "ChaCha" algorithm instead of the default.

use rand::{thread_rng, ChaChaRng, distributions};

let mut rng = ChaChaRng::from_rng(&mut thread_rng()).unwrap();
println!("random between 0-9: {}", distributions::range(0, 10, &mut rng));

Unfortunately, cargo test does not test everything. The following tests are recommended:

# Basic tests for rand and sub-crates
cargo test --all

# Test no_std support (build only since nearly all tests require std)
cargo build --all --no-default-features

# Test 128-bit support (requires nightly)
cargo test --all --features i128_support

# Benchmarks (requires nightly)
cargo bench

rand is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See LICENSE-APACHE, and LICENSE-MIT for details.