fastalloc 1.5.0

High-performance memory pooling library with type-safe handles, predictable latency, and zero fragmentation. Perfect for game engines, real-time systems, and high-churn workloads.
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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

use criterion::{black_box, criterion_group, criterion_main, BenchmarkId, Criterion, Throughput};
use fastalloc::{FixedPool, GrowingPool, PoolConfig};

fn bench_fixed_pool_allocation(c: &mut Criterion) {
    let mut group = c.benchmark_group("fixed_pool_allocation");

    for size in [100, 1000, 10000].iter() {
        group.throughput(Throughput::Elements(*size as u64));

        group.bench_with_input(BenchmarkId::from_parameter(size), size, |b, &size| {
            let pool = FixedPool::<i32>::new(size).unwrap();
            b.iter(|| {
                let handle = pool.allocate(black_box(42)).unwrap();
                black_box(handle);
            });
        });
    }

    group.finish();
}

fn bench_growing_pool_allocation(c: &mut Criterion) {
    let mut group = c.benchmark_group("growing_pool_allocation");

    for size in [100, 1000, 10000].iter() {
        group.throughput(Throughput::Elements(*size as u64));

        group.bench_with_input(BenchmarkId::from_parameter(size), size, |b, &size| {
            let config = PoolConfig::builder()
                .capacity(size)
                .growth_strategy(fastalloc::GrowthStrategy::Exponential { factor: 2.0 })
                .build()
                .unwrap();
            let pool = GrowingPool::with_config(config).unwrap();

            b.iter(|| {
                let handle = pool.allocate(black_box(42)).unwrap();
                black_box(handle);
            });
        });
    }

    group.finish();
}

fn bench_box_allocation(c: &mut Criterion) {
    let mut group = c.benchmark_group("box_allocation_baseline");

    for size in [100, 1000, 10000].iter() {
        group.throughput(Throughput::Elements(*size as u64));

        group.bench_with_input(BenchmarkId::from_parameter(size), size, |b, _size| {
            b.iter(|| {
                let boxed = Box::new(black_box(42));
                black_box(boxed);
            });
        });
    }

    group.finish();
}

fn bench_allocation_reuse(c: &mut Criterion) {
    let mut group = c.benchmark_group("allocation_reuse");

    let pool = FixedPool::<i32>::new(100).unwrap();

    group.bench_function("reuse_pattern", |b| {
        b.iter(|| {
            let handle = pool.allocate(black_box(42)).unwrap();
            black_box(&handle);
            drop(handle);
            let handle = pool.allocate(black_box(99)).unwrap();
            black_box(&handle);
        });
    });

    group.finish();
}

fn bench_different_sizes(c: &mut Criterion) {
    let mut group = c.benchmark_group("allocation_by_type_size");

    // Small type
    group.bench_function("u8", |b| {
        let pool = FixedPool::<u8>::new(1000).unwrap();
        b.iter(|| {
            let handle = pool.allocate(black_box(42u8)).unwrap();
            black_box(handle);
        });
    });

    // Medium type
    group.bench_function("u128", |b| {
        let pool = FixedPool::<u128>::new(1000).unwrap();
        b.iter(|| {
            let handle = pool.allocate(black_box(42u128)).unwrap();
            black_box(handle);
        });
    });

    // Large type
    #[derive(Clone)]
    struct LargeStruct([u64; 32]);
    impl fastalloc::Poolable for LargeStruct {}

    group.bench_function("large_struct_256_bytes", |b| {
        let pool = FixedPool::<LargeStruct>::new(1000).unwrap();
        b.iter(|| {
            let handle = pool.allocate(black_box(LargeStruct([0; 32]))).unwrap();
            black_box(handle);
        });
    });

    group.finish();
}

criterion_group!(
    benches,
    bench_fixed_pool_allocation,
    bench_growing_pool_allocation,
    bench_box_allocation,
    bench_allocation_reuse,
    bench_different_sizes
);
criterion_main!(benches);