Struct SymbolPool 

pub struct SymbolPool { /* private fields */ }

A pool of fixed-size symbol buffers.

Implementations

impl SymbolPool

pub fn new(config: PoolConfig) -> Self

Creates a new symbol pool using the provided configuration.

br-asupersync-jpzl5a — Mints pool_id from a process-global counter. This is fine for accounting / back-pressure decisions where the only contract is “distinct pools have distinct ids”, but it leaks ambient identity that breaks deterministic replay across separate LabRuntime instances. Determinism-sensitive callers should use Self::new_with_pool_id and supply an ID minted from the runtime-scoped allocator they already hold.

pub fn new_with_pool_id(config: PoolConfig, pool_id: u64) -> Self

br-asupersync-jpzl5a — Creates a new symbol pool with an explicit pool_id. Use this from runtime-scoped factories that want pool identity tied to a deterministic allocator (e.g. a per-runtime counter or a Cx-derived hash) rather than the process-global atomic in Self::new.

pub fn config(&self) -> &PoolConfig

Returns the current pool configuration.

pub fn stats(&self) -> &PoolStats

Returns pool usage statistics.

pub fn free_count(&self) -> usize

Returns the number of buffers currently available in the free list.

pub fn reset_stats(&mut self)

Resets pool statistics while keeping current usage.

pub fn allocate(&mut self) -> Result<SymbolBuffer, PoolExhausted>

Allocates a symbol buffer or returns PoolExhausted.

pub fn try_allocate(&mut self) -> Option<SymbolBuffer>

Attempts to allocate a symbol buffer without blocking.

pub fn deallocate(&mut self, buffer: SymbolBuffer)

Returns a buffer to the pool.

Panics

Panics if the buffer’s size does not match the pool’s configured symbol size, if it was never checked out from a pool, or if it belongs to a different pool.

pub fn shrink_to_fit(&mut self)

Shrinks the free list to the minimum size based on the initial pool size.

pub fn warm(&mut self, count: usize)

Ensures the pool has at least count free buffers.

Trait Implementations

impl Debug for SymbolPool

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

Formats the value using the given formatter.