Struct StackPool

Source

pub struct StackPool<T: Clone> { /* private fields */ }

Expand description

A pool of reusable stacks to reduce allocation overhead.

§Examples

use adze_stack_pool_core::StackPool;

let pool: StackPool<u32> = StackPool::new(4);
let mut stack = pool.acquire();
stack.push(42);
pool.release(stack);

let reused = pool.acquire();
assert!(reused.is_empty()); // cleared on reuse
assert_eq!(pool.stats().reuse_count, 1);

Implementations§

Source §

impl<T: Clone> StackPool<T>

Source

pub fn new(max_pool_size: usize) -> Self

Create a new stack pool with the specified maximum size.

§Examples

use adze_stack_pool_core::StackPool;

let pool: StackPool<i32> = StackPool::new(8);
assert_eq!(pool.stats().total_allocations, 0);

Source

pub fn acquire(&self) -> Vec<T>

Acquire a stack from the pool, or allocate a new one if pool is empty.

§Examples

use adze_stack_pool_core::StackPool;

let pool: StackPool<u32> = StackPool::new(4);
let stack = pool.acquire();
assert_eq!(stack.capacity(), 256);
assert_eq!(pool.stats().pool_misses, 1);

Source

pub fn acquire_with_capacity(&self, capacity: usize) -> Vec<T>

Acquire a stack with at least the requested capacity.

Source

pub fn release(&self, stack: Vec<T>)

Return a stack to the pool for reuse.

§Examples

use adze_stack_pool_core::StackPool;

let pool: StackPool<u32> = StackPool::new(4);
let stack = pool.acquire();
pool.release(stack);
assert_eq!(pool.stats().max_pool_depth, 1);

Source

pub fn clone_stack(&self, source: &[T]) -> Vec<T>

Clone a stack, potentially using a pooled stack for the destination.

§Examples

use adze_stack_pool_core::StackPool;

let pool: StackPool<u32> = StackPool::new(4);
let original = vec![1, 2, 3];
let cloned = pool.clone_stack(&original);
assert_eq!(cloned, vec![1, 2, 3]);

Source

pub fn stats(&self) -> PoolStats

Get current pool statistics.

§Examples

use adze_stack_pool_core::StackPool;

let pool: StackPool<u32> = StackPool::new(4);
let _ = pool.acquire();
let stats = pool.stats();
assert_eq!(stats.total_allocations, 1);
assert_eq!(stats.pool_misses, 1);

Source