alea 0.2.0

A crate for randomness.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# alea


[![Crates.io](https://img.shields.io/crates/v/alea)](https://crates.io/crates/alea)
[![Documentation](https://docs.rs/alea/badge.svg)](https://docs.rs/alea)
![License](https://img.shields.io/crates/l/alea?label=License)

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](https://github.com/wangyi-fudan/wyhash), a high-quality and fast generator. 

This crate is heavily inspired by [`fastrand`](https://github.com/smol-rs/fastrand).

## Examples

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 = 1_000_000;

let mut v = vec![0; n];
for i in 0..n {
  v[i] = alea::i32_in_range(-200, 150);
}
```

Seed the generator to get reproducible results:
```rust
alea::set_seed(10);
```

## Benchmarks

Benchmarks are run with [`criterion.rs`](https://github.com/bheisler/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  |