nolock 0.4.1

A collection of Lock-Free Datastructures
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

use super::size_classes;

mod stack;
use stack::Stack;

mod flush_iter;
pub use flush_iter::FlushIter;

/// The Size to use for the Cache-Stacks
const STACK_SIZE: usize = 32;

/// The Thread-Local Cache for lrmalloc
#[derive(Debug)]
pub struct Cache {
    /// Holds a Stack for all the SizeClasses used by the Allocator
    stacks: [Stack<u8, STACK_SIZE>; size_classes::size_class_count()],
}

impl Cache {
    /// Creates a new empty Cache
    pub const fn new() -> Self {
        Self {
            stacks: [Stack::new(); size_classes::size_class_count()],
        }
    }

    /// Gets the fixed size of the Stacks used by the Cache
    pub const fn get_stack_size() -> usize {
        STACK_SIZE
    }

    /// Attempts to allocate from the Cache by trying to get a Ptr from the
    /// Stack for the given SizeClass
    pub fn try_alloc(&mut self, size_class: usize) -> Option<*mut u8> {
        let stack = self.stacks.get_mut(size_class).expect("The Cache should have a stack for every used Size-Class and this should therefore never fail");
        stack.try_pop()
    }

    /// Attempts to add the given Block-Ptr to the Stack for the given SizeClass
    pub fn add_block(&mut self, size_class: usize, block: *mut u8) -> Result<(), *mut u8> {
        let stack = self.stacks.get_mut(size_class).expect("");
        stack.try_push(block)
    }

    /// Creates the FlushIter for the given SizeClass
    pub fn flush(&mut self, size_class: usize) -> FlushIter<'_, u8, 32> {
        let stack = self.stacks.get_mut(size_class).unwrap();
        FlushIter::new(stack)
    }
}