Struct BumpAllocator 

pub struct BumpAllocator<G = ()> { /* private fields */ }

Bump allocator that grows upward from HEAP_START.

Generic parameter G allows for optional global state storage at the heap start. Use G = () (the default) for no global state.

Safety

Only one instance should exist per program, and it must be set as the global allocator. Creating multiple instances or using alongside another allocator is undefined behavior.

Implementations

impl<G> BumpAllocator<G>

pub const unsafe fn new() -> Self

Creates a new allocator.

Safety

• Only one BumpAllocator instance should exist per program
• It must be set as the global allocator
• Multiple instances or using alongside another allocator leads to undefined behavior
• The Rialo runtime must have zero-initialized the heap region (guaranteed by spec)

impl<G: Zeroable> BumpAllocator<G>

pub fn global(&self) -> &G

Returns reference to global state reserved at heap start

Trait Implementations

impl<G: Zeroable> GlobalAlloc for BumpAllocator<G>

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 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.

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.