Struct BufferPool 

pub struct BufferPool { /* private fields */ }

A pool of reusable byte buffers organized by size class.

Obtain a buffer with BufferPool::acquire; it is automatically returned when the PooledBuffer is dropped.

Implementations

impl BufferPool

pub fn new(capacity_per_class: usize) -> Arc<Self>

Create a new pool wrapping at most capacity_per_class idle buffers per size class.

pub fn acquire(self: &Arc<Self>, min_size: usize) -> PooledBuffer

Acquire a buffer large enough to hold min_size bytes.

The returned PooledBuffer tracks its size class and will return itself to the pool when dropped.

If min_size exceeds the largest size class (1 MB), a fresh allocation is issued on every call and the buffer is not pooled on release. In this case misses is incremented.

pub fn release(&self, buffer: Vec<u8>, size_class: usize)

Return a buffer to the pool.

This is called automatically by PooledBuffer::drop.

pub fn allocations(&self) -> u64

Total number of acquire calls.

pub fn recycles(&self) -> u64

Number of acquisitions served from the free list.

pub fn misses(&self) -> u64

Number of acquisitions that required a fresh heap allocation.

pub fn stats(&self) -> BufferPoolStats

Return a snapshot of all counters.