A crate for fast number generation, with a focus on ease of use (no more passing &mut rng everywhere!).
The implementation is based on WyHash, a high-quality and fast generator.
This crate is heavily inspired by fastrand.
Coin flip:
rust
if alea::bool() {
println!("heads");
} else {
println!("tails");
}
Generate a u64:
rust
let u = alea::u64();
Fill a vector with random integers in some range: ```rust let n = 1000000;
let mut v = vec![0; n]; for i in 0..n { v[i] = alea::i32inrange(-200, 150); } ```
Seed the generator to get reproducible results:
rust
alea::set_seed(10);
Benchmarks are run with criterion.rs. The reported values are the means and standard deviations.
| | alea | fastrand | |--------------|-------------------------|--------------------------| | f64 | 2.0002 ns +/- 21.718 ps | 3.6868 ns +/- 40.030 ps | | f32 | 2.0911 ns +/- 87.985 ps | 2.6735 ns +/- 35.334 ps | | u64 | 2.0062 ns +/- 13.639 ps | 5.1602 ns +/- 132.48 ps | | u32 | 1.9777 ns +/- 4.3646 ps | 4.5852 ns +/- 120.84 ps | | u64 in range | 4.5298 ns +/- 99.716 ps | 5.1845 ns +/- 240.30 ps | | u32 in range | 2.6764 ns +/- 32.698 ps | 4.3292 ns +/- 20.041 ps | | i64 | 2.0042 ns +/- 23.321 ps | 3.7119 ns +/- 44.196 ps | | i32 | 1.9826 ns +/- 10.443 ps | 2.6396 ns +/- 7.6008 ps | | i64 in range | 4.4474 ns +/- 96.470 ps | 3.8003 ns +/- 16.704 ps | | i32 in range | 2.4168 ns +/- 19.926 ps | 2.7006 ns +/- 6.5716 ps |