Struct RawPool

pub struct RawPool<T: RawPoolable + 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: RawPoolable + Send + 'static> RawPool<T>

pub fn downgrade(&self) -> WeakPool<T>

pub fn new(max_capacity: usize, max_elt_capacity: usize) -> RawPool<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 try_take(&self) -> Option<T>

try to take an element from the pool, return None if it is empty

pub fn take(&self) -> T

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

pub fn insert(&self, t: T)

Insert an object into the pool. The object may be dropped if the pool is at capacity, or the object has too much capacity.

Trait Implementations

impl<T: Clone + RawPoolable + Send + 'static> Clone for RawPool<T>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug + RawPoolable + Send + 'static> Debug for RawPool<T>

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

Formats the value using the given formatter.

impl<T: RawPoolable + Send + 'static> Drop for RawPool<T>

fn drop(&mut self)

Executes the destructor for this type.