libutils 5.17.24

Common library types for faster development
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

//^
//^ HEAD
//^

//> HEAD -> API
use libutils::array::Array;

//> HEAD -> CORE
use core::hint::black_box;

//> HEAD -> CRITERION
use criterion::{
    criterion_group,
    criterion_main,
    Criterion,
    Throughput
};


//^
//^ BENCHES
//^

//> BENCHES -> ITERATIONS
const ITERATIONS: u64 = 2u64.pow(14);

//> BENCHES -> BENCH
fn bench(criterion: &mut Criterion) -> () {
    let mut group = criterion.benchmark_group("array");
    group.throughput(Throughput::Elements(ITERATIONS));
    group.bench_function("push", |bencher| bencher.iter(push));
    group.bench_function("pushpop", |bencher| bencher.iter(pushpop));
    group.bench_function("insertremove", |bencher| bencher.iter(insertremove));
    group.bench_function("extend", |bencher| bencher.iter(extend));
    group.finish();
}

//> BENCHES -> PUSH
fn push() -> () {
    let mut array = Array::<u64, {ITERATIONS as usize}>::new();
    for index in 0..ITERATIONS {black_box(array.push(black_box(index)))}
}

//> BENCHES -> PUSHPOP
fn pushpop() -> () {
    let mut array = Array::<u64, 1>::new();
    for index in 0..ITERATIONS {
        black_box(array.push(black_box(index)));
        let removed = black_box(array.pop());
        black_box(removed);
    }
}

//> BENCHES -> INSERTREMOVE
fn insertremove() -> () {
    let mut array = Array::<u64, 4>::from([0, 0, 0]);
    for index in 0..ITERATIONS {
        black_box(array.insert(black_box(0), black_box(index)));
        let value = black_box(array.remove(black_box(1)));
        black_box(value);
    }
}

//> BENCHES -> EXTEND
fn extend() -> () {
    let mut array = Array::<u64, {ITERATIONS as usize * 2}>::new();
    for index in 0..ITERATIONS {black_box(array.extend(black_box([index, index])))}
}

//> BENCHES -> SETUP
criterion_group!(benches, bench);
criterion_main!(benches);