Struct netidx_core::pool::Pool

pub struct Pool<T: Poolable + Send + 'static>(/* private fields */);

a lock-free, thread-safe, dynamically-sized object pool.

this pool begins with an initial capacity and will continue creating new objects on request when none are available. Pooled objects are returned to the pool on destruction.

if, during an attempted return, a pool already has maximum_capacity objects in the pool, the pool will throw away that object.

Implementations

impl<T: Poolable + Send + 'static> Pool<T>

pub fn new(max_capacity: usize, max_elt_capacity: usize) -> Pool<T>

creates a new Pool<T>. this pool will retain up to max_capacity objects of size less than or equal to max_elt_capacity. Objects larger than max_elt_capacity will be deallocated immediatly.

pub fn take(&self) -> Pooled<T>

takes an item from the pool, creating one if none are available.

Trait Implementations

impl<T: Clone + Poolable + Send + 'static> Clone for Pool<T>

fn clone(&self) -> Pool<T>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug + Poolable + Send + 'static> Debug for Pool<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Poolable + Send + 'static> Drop for Pool<T>

fn drop(&mut self)

Executes the destructor for this type.