arena-alligator 0.1.0

Lock-free arena allocator producing bytes::Bytes via from_owner
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

//! Buddy arena: variable-size allocations from a shared region.

use std::num::NonZeroUsize;

use arena_alligator::BuddyArena;
use bytes::BufMut;

fn main() {
    let arena = BuddyArena::builder(
        NonZeroUsize::new(1024 * 1024).unwrap(),
        NonZeroUsize::new(256).unwrap(),
    )
    .build()
    .unwrap();

    let mut small = arena.allocate(NonZeroUsize::new(100).unwrap()).unwrap();
    small.put_slice(b"small payload");
    println!("requested 100 B, got {} B capacity", small.capacity());
    let small_bytes = small.freeze();

    let mut large = arena.allocate(NonZeroUsize::new(50_000).unwrap()).unwrap();
    large.put_bytes(0xCD, 50_000);
    println!("requested 50000 B, got {} B capacity", large.capacity());
    let large_bytes = large.freeze();

    let m = arena.metrics();
    println!(
        "splits: {}, largest_free_block: {} B",
        m.splits, m.largest_free_block
    );

    drop(small_bytes);
    drop(large_bytes);

    let m = arena.metrics();
    println!(
        "after drop: coalesces: {}, largest_free_block: {} B",
        m.coalesces, m.largest_free_block
    );
}