alea
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.
Examples
Coin flip:
if bool else
Generate a u64:
let u = u64;
Fill a vector with random integers in some range:
let n = 1_000_000;
let mut v = vec!;
for i in 0..n
Seed the generator to get reproducible results:
set_seed;
Benchmarks
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 |