Struct LinearMemory

pub struct LinearMemory { /* private fields */ }

A linear memory instance.

Implementations

impl LinearMemory

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

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

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

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 LinearMemory 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.

Trait Implementations

impl Debug for LinearMemory

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

Formats the value using the given formatter.

impl Memory for LinearMemory

fn ty(&self) -> MemoryType

Returns the type for this memory.

fn style(&self) -> &MemoryStyle

Returns the memory style for this memory.

fn size(&self) -> Pages

Returns the number of allocated wasm pages.

fn grow(&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 vmmemory(&self) -> NonNull<VMMemoryDefinition>

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

impl Send for LinearMemory

We must implement this because of VMMemoryDefinitionOwnership::VMOwned. This is correct because synchronization of memory accesses is controlled by the VM.

impl Sync for LinearMemory

This is correct because all internal mutability is protected by a mutex.