Struct HybridAllocator 

pub struct HybridAllocator<const N: usize, F: Allocator> { /* private fields */ }

A hybrid allocator that first tries to allocate from a stack‑backed bump allocator and falls back to a user‑provided allocator.

N - size of the stack buffer in bytes. F - the fallback allocator type (e.g. std::alloc::Global or any custom allocator that implements Allocator).

Implementations

impl<const N: usize, F: Allocator> HybridAllocator<N, F>

pub const fn new(fallback: F) -> Self

Create a new hybrid allocator.

The caller supplies the fallback allocator that will be used when the stack buffer cannot satisfy a request.

pub unsafe fn reset(&mut self)

Reset the allocator, discarding all previously allocated memory.

Safety

the caller must guarantee that no live allocation created by this allocator is still in use.

pub fn current_offset(&self) -> usize

Get the current offset of the stack allocator.

pub fn fallback(&self) -> &F

Get a reference to the fallback allocator.

pub fn is_stack_exausted(&self) -> bool

Check if the last allocation used the fallback allocator. if true, the stack buffer is exhausted and all further allocations will go to the fallback until reset is called.

Trait Implementations

impl<const N: usize, F: Allocator> Allocator for HybridAllocator<N, F>

fn allocate(&self, layout: Layout) -> Result<NonNull<[u8]>, AllocError>

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

Attempts to allocate a block of memory.

unsafe fn deallocate(&self, ptr: NonNull<u8>, layout: Layout)

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

Deallocates the memory referenced by ptr.

unsafe fn grow( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<[u8]>, AllocError>

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

Attempts to extend the memory block.

unsafe fn shrink( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<[u8]>, AllocError>

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

Attempts to shrink the memory block.

fn by_ref(&self) -> &Self

where Self: Sized,

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

Creates a “by reference” adapter for this instance of Allocator.

fn allocate_zeroed(&self, layout: Layout) -> Result<NonNull<[u8]>, AllocError>

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

Behaves like allocate, but also ensures that the returned memory is zero-initialized.

unsafe fn grow_zeroed( &self, ptr: NonNull<u8>, old_layout: Layout, new_layout: Layout, ) -> Result<NonNull<[u8]>, AllocError>

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

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