Struct Memory

Source

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

Expand description

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

Implementations§

Source §

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

Source

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.

Source

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

Writes bytes to location.

Source

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.

Source

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

Deallocates the allocation managed by the guest.

Auto Trait Implementations§

§

impl<'runtime, Instance> Freeze for Memory<'runtime, Instance>
where <<Instance as Instance>::Runtime as Runtime>::Memory: Freeze, <Instance as InstanceWithFunction<HCons<i32, HCons<i32, HCons<i32, HCons<i32, HNil>>>>, HCons<i32, HNil>>>::Function: Freeze, <Instance as InstanceWithFunction<HCons<i32, HNil>, HNil>>::Function: Freeze,

§

impl<'runtime, Instance> RefUnwindSafe for Memory<'runtime, Instance>
where <<Instance as Instance>::Runtime as Runtime>::Memory: RefUnwindSafe, Instance: RefUnwindSafe, <Instance as InstanceWithFunction<HCons<i32, HCons<i32, HCons<i32, HCons<i32, HNil>>>>, HCons<i32, HNil>>>::Function: RefUnwindSafe, <Instance as InstanceWithFunction<HCons<i32, HNil>, HNil>>::Function: RefUnwindSafe,

§

impl<'runtime, Instance> Send for Memory<'runtime, Instance>
where <<Instance as Instance>::Runtime as Runtime>::Memory: Send, Instance: Send, <Instance as InstanceWithFunction<HCons<i32, HCons<i32, HCons<i32, HCons<i32, HNil>>>>, HCons<i32, HNil>>>::Function: Send, <Instance as InstanceWithFunction<HCons<i32, HNil>, HNil>>::Function: Send,

§

impl<'runtime, Instance> Sync for Memory<'runtime, Instance>
where <<Instance as Instance>::Runtime as Runtime>::Memory: Sync, Instance: Sync, <Instance as InstanceWithFunction<HCons<i32, HCons<i32, HCons<i32, HCons<i32, HNil>>>>, HCons<i32, HNil>>>::Function: Sync, <Instance as InstanceWithFunction<HCons<i32, HNil>, HNil>>::Function: Sync,

§

impl<'runtime, Instance> Unpin for Memory<'runtime, Instance>
where <<Instance as Instance>::Runtime as Runtime>::Memory: Unpin, <Instance as InstanceWithFunction<HCons<i32, HCons<i32, HCons<i32, HCons<i32, HNil>>>>, HCons<i32, HNil>>>::Function: Unpin, <Instance as InstanceWithFunction<HCons<i32, HNil>, HNil>>::Function: Unpin,

§

impl<'runtime, Instance> !UnwindSafe for Memory<'runtime, Instance>

Blanket Implementations§

Source §

impl<T> Any for T
where T: 'static + ?Sized,

Source §

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

Source §

impl<T> Borrow<T> for T
where T: ?Sized,

Source §

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

Source §

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source §

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

Source §

impl<Choices> CoproductSubsetter<CNil, HNil> for Choices

Source §

type Remainder = Choices

Source §

fn subset( self, ) -> Result<CNil, <Choices as CoproductSubsetter<CNil, HNil>>::Remainder>

Extract a subset of the possible types in a coproduct (or get the remaining possibilities) Read more

Source §

impl<T> From<T> for T

Source §

fn from(t: T) -> T

Returns the argument unchanged.

Source §

impl<T, U> Into for T
where U: From<T>,

Source §

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source §

impl<T> IntoEither for T

Source §

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

Source §

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

Source §