moirai-core 0.5.0

Core abstractions and traits for the Moirai concurrency library
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

use crate::platform::*;

/// Thread-local task pool for zero-allocation task execution
pub struct ThreadLocalPool<T> {
    /// Stack of available objects
    pool: UnsafeCell<Vec<T>>,
    /// Maximum pool size
    max_size: usize,
    /// Marker to ensure !Send and !Sync
    _marker: PhantomData<*const T>,
}

impl<T> ThreadLocalPool<T> {
    /// Create a new thread-local pool
    #[must_use]
    pub fn new(max_size: usize) -> Self {
        Self {
            pool: UnsafeCell::new(Vec::with_capacity(max_size)),
            max_size,
            _marker: PhantomData,
        }
    }

    /// Get an object from the pool or create a new one
    pub fn get_or_create<F>(&self, create: F) -> T
    where
        F: FnOnce() -> T,
    {
        unsafe {
            let pool = &mut *self.pool.get();
            pool.pop().unwrap_or_else(create)
        }
    }

    /// Return an object to the pool
    pub fn put(&self, obj: T) {
        unsafe {
            let pool = &mut *self.pool.get();
            if pool.len() < self.max_size {
                pool.push(obj);
            }
        }
    }
}