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. The maximum size which can be allocated at once is 16 MiB.

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.

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.

Arguments

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