Struct wasmer_vm::VMMemory

pub struct VMMemory(pub Box<dyn LinearMemory + 'static>);

Represents linear memory that can be either owned or shared

Tuple Fields

0: Box<dyn LinearMemory + 'static>

Implementations

impl VMMemory

pub fn new(memory: &MemoryType, style: &MemoryStyle) -> Result<Self, MemoryError>

Creates a new linear memory instance of the correct type with specified minimum and maximum number of wasm pages.

This creates a Memory with owned metadata: this can be used to create a memory that will be imported into Wasm modules.

pub fn get_runtime_size(&self) -> u32

Returns the number of pages in the allocated memory block

pub unsafe fn from_definition(
    memory: &MemoryType,
    style: &MemoryStyle,
    vm_memory_location: NonNull<VMMemoryDefinition>
) -> Result<Self, MemoryError>

Create a new linear memory instance with specified minimum and maximum number of wasm pages.

This creates a Memory with metadata owned by a VM, pointed to by vm_memory_location: this can be used to create a local memory.

Safety

• vm_memory_location must point to a valid location in VM memory.

pub fn from_custom<IntoVMMemory>(memory: IntoVMMemory) -> VMMemorywhere
    IntoVMMemory: Into<VMMemory>,

Creates VMMemory from a custom implementation - the following into implementations are natively supported

• VMOwnedMemory -> VMMemory
• Box<dyn LinearMemory + ’static> -> VMMemory

Trait Implementations

impl Debug for VMMemory

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

Formats the value using the given formatter.

impl From<Box<dyn LinearMemory + 'static, Global>> for VMMemory

fn from(mem: Box<dyn LinearMemory + 'static>) -> Self

Converts to this type from the input type.

impl From<VMOwnedMemory> for VMMemory

fn from(mem: VMOwnedMemory) -> Self

Converts to this type from the input type.

impl From<VMSharedMemory> for VMMemory

fn from(mem: VMSharedMemory) -> Self

Converts to this type from the input type.

impl LinearMemory for VMMemory

fn ty(&self) -> MemoryType

Returns the type for this memory.

fn size(&self) -> Pages

Returns the size of hte memory in pages

fn grow(&mut self, delta: Pages) -> Result<Pages, MemoryError>

Grow memory by the specified amount of wasm pages.

Returns None if memory can’t be grown by the specified amount of wasm pages.

fn style(&self) -> MemoryStyle

Returns the memory style for this memory.

fn vmmemory(&self) -> NonNull<VMMemoryDefinition>

Return a VMMemoryDefinition for exposing the memory to compiled wasm code.

fn try_clone(&self) -> Option<Box<dyn LinearMemory + 'static>>

Attempts to clone this memory (if its clonable)