Struct StratifiedMemoryPool 

pub struct StratifiedMemoryPool { /* private fields */ }

Multi-size memory pool with automatic bucket selection.

Instead of having a single buffer size, this pool maintains separate pools for different size classes. Allocations are rounded up to the smallest bucket that fits.

Example

use ringkernel_core::memory::{StratifiedMemoryPool, SizeBucket};

let pool = StratifiedMemoryPool::new("my_pool");

// Allocate various sizes - each goes to appropriate bucket
let tiny_buf = pool.allocate(100);   // Uses Tiny bucket (256B)
let medium_buf = pool.allocate(2000); // Uses Medium bucket (4KB)

// Check statistics
let stats = pool.stats();
println!("Hit rate: {:.1}%", stats.hit_rate() * 100.0);

Implementations

impl StratifiedMemoryPool

pub fn new(name: impl Into<String>) -> Self

Create a new stratified pool with default settings.

Creates pools for all bucket sizes with 16 buffers per bucket.

pub fn with_capacity( name: impl Into<String>, max_buffers_per_bucket: usize, ) -> Self

Create a pool with specified max buffers per bucket.

pub fn allocate(&self, size: usize) -> StratifiedBuffer<'_>

Allocate a buffer of at least the requested size.

The buffer may be larger than requested (rounded up to bucket size).

pub fn allocate_bucket(&self, bucket: SizeBucket) -> StratifiedBuffer<'_>

Allocate from a specific bucket.

pub fn name(&self) -> &str

Get pool name.

pub fn max_buffers_per_bucket(&self) -> usize

Get max buffers per bucket.

pub fn bucket_size(&self, bucket: SizeBucket) -> usize

Get current size of a specific bucket pool.

pub fn total_pooled(&self) -> usize

Get total buffers currently pooled across all buckets.

pub fn stats(&self) -> StratifiedPoolStats

Get statistics snapshot.

pub fn preallocate(&self, bucket: SizeBucket, count: usize)

Pre-allocate buffers for a specific bucket.

pub fn preallocate_all(&self, count_per_bucket: usize)

Pre-allocate buffers for all buckets.

pub fn shrink_to(&self, target_per_bucket: usize)

Shrink all pools to target utilization.

Removes excess pooled buffers to free memory.