Struct linera_witty::Memory

pub struct Memory<'runtime, Instance>
where
    Instance: CabiReallocAlias + CabiFreeAlias,
{ /* private fields */ }

A handle to interface with a guest Wasm module instance’s memory.

Implementations

impl<Instance> Memory<'_, Instance>

where Instance: CabiReallocAlias + CabiFreeAlias, <Instance::Runtime as Runtime>::Memory: RuntimeMemory<Instance>,

pub fn read( &self, location: GuestPointer, length: u32, ) -> Result<Cow<'_, [u8]>, RuntimeError>

Reads length bytes from location.

The underlying runtime may return either a memory slice or an owned buffer.

pub fn write( &mut self, location: GuestPointer, bytes: &[u8], ) -> Result<(), RuntimeError>

Writes bytes to location.

pub fn allocate( &mut self, size: u32, alignment: u32, ) -> Result<GuestPointer, RuntimeError>

Returns a newly allocated buffer of size bytes in the guest module’s memory aligned to the requested alignment.

Calls the guest module to allocate the memory, so the resulting allocation is managed by the guest.

pub fn deallocate( &mut self, allocation: GuestPointer, ) -> Result<(), RuntimeError>

Deallocates the allocation managed by the guest.