Struct sp_allocator::FreeingBumpHeapAllocator

pub struct FreeingBumpHeapAllocator { /* fields omitted */ }

An implementation of freeing bump allocator.

Refer to the module-level documentation for further details.

Implementations

impl FreeingBumpHeapAllocator

pub fn new(heap_base: u32) -> Self

Creates a new allocation heap which follows a freeing-bump strategy.

Arguments

• heap_base - the offset from the beginning of the linear memory where the heap starts.

pub fn allocate<M: Memory + ?Sized>(
    &mut self,
    mem: &mut M,
    size: WordSize
) -> Result<Pointer<u8>, Error>

Gets requested number of bytes to allocate and returns a pointer. The maximum size which can be allocated at once is 16 MiB. There is no minimum size, but whatever size is passed into this function is rounded to the next power of two. If the requested size is below 8 bytes it will be rounded up to 8 bytes.

NOTE: Once the allocator has returned an error all subsequent requests will return an error.

Arguments

• mem - a slice representing the linear memory on which this allocator operates.
• size - size in bytes of the allocation request

pub fn deallocate<M: Memory + ?Sized>(
    &mut self,
    mem: &mut M,
    ptr: Pointer<u8>
) -> Result<(), Error>

Deallocates the space which was allocated for a pointer.

NOTE: Once the allocator has returned an error all subsequent requests will return an error.

Arguments

• mem - a slice representing the linear memory on which this allocator operates.
• ptr - pointer to the allocated chunk