Struct ThreadLocalPool 

pub struct ThreadLocalPool<T> { /* private fields */ }

A reusable-object pool for a single logical context.

Implementations

impl<T> ThreadLocalPool<T>

pub fn new(capacity: usize) -> Self

Create a pool with maximum capacity free objects.

pub fn warm_up(&mut self, count: usize, factory: impl Fn() -> T)

Pre-populate the pool with objects produced by factory.

pub fn acquire(&mut self, factory: impl FnOnce() -> T) -> T

Obtain an object from the pool, or allocate a new one via factory.

pub fn release(&mut self, obj: T)

Return an object to the pool. If the pool is at capacity, the object is dropped.

pub fn free_count(&self) -> usize

Number of objects currently in the free pool.

pub fn capacity(&self) -> usize

pub fn alloc_count(&self) -> u64

pub fn recycle_count(&self) -> u64

pub fn overflow_count(&self) -> u64

pub fn is_empty(&self) -> bool

pub fn is_full(&self) -> bool

pub fn drain(&mut self) -> Vec<T>

Drain all free objects (e.g. at shutdown).