Struct BufferPool 

pub struct BufferPool { /* private fields */ }

Page-aligned arena carved into total_chunks fixed-size chunks, handed out and reclaimed via a TreiberStack free-list.

Implementations

impl BufferPool

pub fn new(total_chunks: usize, chunk_size: usize) -> Self

Allocate a page-aligned arena of total_chunks chunks of chunk_size bytes each, with all chunks initially free.

Panics

Panics if total_chunks * chunk_size (each floored to at least 1) overflows or produces a layout with invalid size/alignment for the global allocator (Layout::from_size_align failure), or if the allocator itself fails to satisfy the allocation (handle_alloc_error).

pub const fn get_ptr(&self, idx: u32) -> *mut u8

Raw pointer to the start of chunk idx within the arena. idx must be < total_chunks as passed to Self::new — out-of-range indices produce a pointer outside the arena allocation, which is unsound to dereference (this function itself performs no dereference, only pointer arithmetic).

pub const fn chunk_size(&self) -> usize

The fixed chunk size (in bytes) this pool was constructed with.

pub fn acquire(&self) -> Option<u32>

Borrow a chunk index from the pool; None if exhausted.

pub fn release(&self, idx: u32)

Return a chunk index to the pool.

Trait Implementations

impl Drop for BufferPool

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Send for BufferPool

impl Sync for BufferPool