Struct PoolStatistics 

pub struct PoolStatistics {
    pub total_allocations: usize,
    pub total_deallocations: usize,
    pub current_usage: usize,
    pub peak_usage: usize,
    pub capacity: usize,
    pub growth_count: usize,
    pub allocation_failures: usize,
}

Available on crate feature stats only.

Statistics about pool usage and performance.

Examples

#[cfg(feature = "stats")]
{
    use fastalloc::FixedPool;

    let pool = FixedPool::<i32>::new(100).unwrap();
     
    let _h1 = pool.allocate(1).unwrap();
    let _h2 = pool.allocate(2).unwrap();
     
    let stats = pool.statistics();
    assert_eq!(stats.current_usage, 2);
    assert_eq!(stats.total_allocations, 2);
}

Fields

total_allocations: usize

Total number of allocations ever made

total_deallocations: usize

Total number of deallocations ever made

current_usage: usize

Current number of allocated objects

peak_usage: usize

Peak number of simultaneously allocated objects

capacity: usize

Current capacity of the pool

growth_count: usize

Number of times the pool has grown (for growing pools)

allocation_failures: usize

Number of allocation failures

Implementations

impl PoolStatistics

pub fn new(capacity: usize) -> Self

Creates a new statistics instance with all counters at zero.

pub fn utilization_rate(&self) -> f64

Returns the utilization rate as a percentage (0.0 to 100.0).

pub fn peak_utilization_rate(&self) -> f64

Returns the peak utilization rate as a percentage (0.0 to 100.0).

pub fn hit_rate(&self) -> f64

Returns the hit rate (successful allocations / total attempts).

pub fn available(&self) -> usize

Returns the number of currently available slots.

Trait Implementations

impl Clone for PoolStatistics

fn clone(&self) -> PoolStatistics

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PoolStatistics

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PoolStatistics

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for PoolStatistics

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

Formats the value using the given formatter.

impl PartialEq for PoolStatistics

fn eq(&self, other: &PoolStatistics) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for PoolStatistics

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for PoolStatistics

impl Eq for PoolStatistics

impl StructuralPartialEq for PoolStatistics