Struct BumpAllocator 

pub struct BumpAllocator<P: MemoryPool> { /* private fields */ }

Bump allocator for sequential allocations

Simple and fast allocator that only supports allocation, not deallocation of individual items. Perfect for temporary buffers and stack-like usage.

Implementations

impl<P: MemoryPool> BumpAllocator<P>

pub const fn new(pool: P) -> Self

Create a new bump allocator with the given pool

pub fn allocate(&self, size: usize, align: usize) -> Result<NonNull<u8>>

Allocate memory from the bump allocator

Errors

Returns error if the pool is exhausted or alignment requirements cannot be met

pub fn capacity(&self) -> usize

Get the total capacity

pub fn used(&self) -> usize

Get currently used bytes

pub fn available(&self) -> usize

Get available bytes

pub unsafe fn reset(&self) -> Result<()>

Reset the allocator (reclaim all memory)

Safety

All pointers allocated from this allocator must not be used after reset

Trait Implementations

impl<P: MemoryPool + Sync> GlobalAlloc for BumpAllocator<P>

Available on crate feature alloc only.

unsafe fn alloc(&self, layout: Layout) -> *mut u8

Allocates memory as described by the given layout.

unsafe fn dealloc(&self, ptr: *mut u8, layout: Layout)

Deallocates the block of memory at the given ptr pointer with the given layout.

unsafe fn alloc_zeroed(&self, layout: Layout) -> *mut u8

Behaves like alloc, but also ensures that the contents are set to zero before being returned.

unsafe fn realloc( &self, ptr: *mut u8, layout: Layout, new_size: usize, ) -> *mut u8

Shrinks or grows a block of memory to the given new_size in bytes. The block is described by the given ptr pointer and layout.