4 A Rust library for random number generators and other randomness functionality.
6 [![Build Status](https://travis-ci.org/rust-lang-nursery/rand.svg?branch=master)](https://travis-ci.org/rust-lang-nursery/rand)
7 [![Build status](https://ci.appveyor.com/api/projects/status/rm5c9o33k3jhchbw?svg=true)](https://ci.appveyor.com/project/alexcrichton/rand)
9 [Documentation](https://docs.rs/rand)
13 Add this to your `Cargo.toml`:
20 and this to your crate root:
28 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.
31 let tuple = rand::random::<(f64, char)>();
32 println!("{:?}", tuple)
38 let mut rng = rand::thread_rng();
39 if rng.gen() { // random bool
40 println!("i32: {}, u32: {}", rng.gen::<i32>(), rng.gen::<u32>())
44 It is also possible to use other RNG types, which have a similar interface. The following uses the "ChaCha" algorithm instead of the default.
47 use rand::{Rng, ChaChaRng};
49 let mut rng = rand::ChaChaRng::new_unseeded();
50 println!("i32: {}, u32: {}", rng.gen::<i32>(), rng.gen::<u32>())
55 You can derive the `Rand` trait for your custom type via the `#[derive(Rand)]`
56 directive. To use this first add this to your Cargo.toml:
68 extern crate rand_derive;
70 #[derive(Rand, Debug)]
77 println!("{:?}", rand::random::<MyStruct>());
84 `rand` is primarily distributed under the terms of both the MIT
85 license and the Apache License (Version 2.0), with portions covered by various
88 See LICENSE-APACHE, and LICENSE-MIT for details.