Struct AllocationsContext

pub struct AllocationsContext { /* private fields */ }

Pages allocations context for the running program.

Implementations

impl AllocationsContext

pub fn try_new( memory_size: WasmPagesAmount, allocations: IntervalsTree<WasmPage>, static_pages: WasmPagesAmount, stack_end: Option<WasmPage>, max_pages: WasmPagesAmount, ) -> Result<Self, MemorySetupError>

New allocations context.

Provide currently running program_id, boxed memory abstraction and allocation manager. Also configurable static_pages and max_pages are set.

Returns MemorySetupError on incorrect memory params.

pub fn alloc<Context, G: GrowHandler<Context>>( &mut self, ctx: &mut Context, mem: &mut impl Memory<Context>, pages: WasmPagesAmount, charge_gas_for_grow: impl FnOnce(WasmPagesAmount) -> Result<(), ChargeError>, ) -> Result<WasmPage, AllocError>

Allocates specified number of continuously going pages and returns zero-based number of the first one.

pub fn free(&mut self, page: WasmPage) -> Result<(), AllocError>

Free specific memory page.

pub fn free_range( &mut self, interval: Interval<WasmPage>, ) -> Result<(), AllocError>

Try to free pages in range. Will only return error if range is invalid.

Currently running program should own this pages.

pub fn into_parts( self, ) -> (WasmPagesAmount, IntervalsTree<WasmPage>, IntervalsTree<WasmPage>)

Decomposes this instance and returns allocations.

Trait Implementations

impl Debug for AllocationsContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.