Clone this repo:
  1. 00316a0 Fix paths to Fuchsia crates. by P.Y. Laligand · 6 days ago master
  2. 131fe68 switch to path dependencies for first party crates by James Tucker · 6 days ago
  3. 76e5f19 Add README.fuchsia by Michael Anthony Knyszek · 14 days ago
  4. cbfb7cf Merge pull request #174 from raggi/0.3.17 by Alex Crichton · 2 weeks ago 0.3.17
  5. 611d55b Bump to 0.3.17 by James Tucker · 2 weeks ago


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

Build Status Build status



Add this to your Cargo.toml:

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, or used implicitly via random. This RNG is normally randomly seeded from an operating-system source of randomness, e.g. /dev/urandom on Unix systems, and will automatically reseed itself from this source after generating 32 KiB of random data.

let tuple = rand::random::<(f64, char)>();
println!("{:?}", tuple)
use rand::Rng;

let mut rng = rand::thread_rng();
if rng.gen() { // random bool
    println!("i32: {}, u32: {}", rng.gen::<i32>(), rng.gen::<u32>())

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

use rand::{Rng, ChaChaRng};

let mut rng = rand::ChaChaRng::new_unseeded();
println!("i32: {}, u32: {}", rng.gen::<i32>(), rng.gen::<u32>())


You can derive the Rand trait for your custom type via the #[derive(Rand)] directive. To use this first add this to your Cargo.toml:

rand = "0.3"
rand_derive = "0.3"

Next in your crate:

extern crate rand;
extern crate rand_derive;

#[derive(Rand, Debug)]
struct MyStruct {
    a: i32,
    b: u32,

fn main() {
    println!("{:?}", rand::random::<MyStruct>());


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.