rdrand 0.9.0

An implementation of random number generator based on rdrand and rdseed instructions
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

use criterion::{criterion_group, criterion_main, Criterion, Throughput};
use rand_core::{Rng, TryRng, UnwrapErr};
use rand::RngExt;

fn bench_rdrand(c: &mut Criterion) {
    let mut rng = match rdrand::RdRand::new() {
        Ok(g) => UnwrapErr(g),
        Err(_) => return,
    };
    let mut group = c.benchmark_group("rdrand");

    group
        .throughput(Throughput::Bytes(2))
        .bench_function("next/u16", move |b| {
            b.iter(move || rng.random::<u16>())
        });
    group
        .throughput(Throughput::Bytes(4))
        .bench_function("try_next/u32", move |b| {
            b.iter(move || rng.try_next_u32().unwrap())
        });
    group
        .throughput(Throughput::Bytes(4))
        .bench_function("next/u32", move |b| b.iter(move || rng.next_u32()));
    group
        .throughput(Throughput::Bytes(8))
        .bench_function("try_next/u64", move |b| {
            b.iter(move || rng.try_next_u64().unwrap())
        });
    group
        .throughput(Throughput::Bytes(8))
        .bench_function("next/u64", move |b| b.iter(move || rng.next_u64()));
    let mut buffer = [0; 128];
    group
        .throughput(Throughput::Bytes(128))
        .bench_function("try_next/fill128", |b| {
            b.iter(|| rng.try_fill_bytes(&mut buffer).unwrap())
        });
    group
        .throughput(Throughput::Bytes(128))
        .bench_function("next/fill128", |b| b.iter(|| rng.fill_bytes(&mut buffer)));

    group.finish();
}

fn bench_rdseed(c: &mut Criterion) {
    let mut rng = match rdrand::RdSeed::new() {
        Ok(g) => UnwrapErr(g),
        Err(_) => return,
    };
    let mut group = c.benchmark_group("rdseed");

    group
        .throughput(Throughput::Bytes(2))
        .bench_function("next/u16", move |b| {
            b.iter(move || rng.random::<u16>())
        });
    group
        .throughput(Throughput::Bytes(4))
        .bench_function("try_next/u32", move |b| {
            b.iter(move || rng.try_next_u32().unwrap())
        });
    group
        .throughput(Throughput::Bytes(4))
        .bench_function("next/u32", move |b| b.iter(move || rng.next_u32()));
    group
        .throughput(Throughput::Bytes(8))
        .bench_function("try_next/u64", move |b| {
            b.iter(move || rng.try_next_u64().unwrap())
        });
    group
        .throughput(Throughput::Bytes(8))
        .bench_function("next/u64", move |b| b.iter(move || rng.next_u64()));
    let mut buffer = [0; 128];
    group
        .throughput(Throughput::Bytes(128))
        .bench_function("try_next/fill128", |b| {
            b.iter(|| rng.try_fill_bytes(&mut buffer).unwrap())
        });
    group
        .throughput(Throughput::Bytes(128))
        .bench_function("next/fill128", |b| b.iter(|| rng.fill_bytes(&mut buffer)));

    group.finish();
}

criterion_group!(benches, bench_rdrand, bench_rdseed);
criterion_main!(benches);