pub struct VMMemory(pub Box<dyn LinearMemory + 'static>);
Expand description
Represents linear memory that can be either owned or shared
Tuple Fields§
§0: Box<dyn LinearMemory + 'static>
Implementations§
source§impl VMMemory
impl VMMemory
sourcepub fn new(
memory: &MemoryType,
style: &MemoryStyle,
) -> Result<Self, MemoryError>
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.
sourcepub fn get_runtime_size(&self) -> u32
pub fn get_runtime_size(&self) -> u32
Returns the number of pages in the allocated memory block
sourcepub unsafe fn from_definition(
memory: &MemoryType,
style: &MemoryStyle,
vm_memory_location: NonNull<VMMemoryDefinition>,
) -> Result<Self, MemoryError>
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.
sourcepub fn from_custom<IntoVMMemory>(memory: IntoVMMemory) -> Selfwhere
IntoVMMemory: Into<Self>,
pub fn from_custom<IntoVMMemory>(memory: IntoVMMemory) -> Selfwhere
IntoVMMemory: Into<Self>,
Creates VMMemory from a custom implementation - the following into implementations are natively supported
- VMOwnedMemory -> VMMemory
- Box<dyn LinearMemory + ’static> -> VMMemory
sourcepub fn copy(&mut self) -> Result<Box<dyn LinearMemory + 'static>, MemoryError>
pub fn copy(&mut self) -> Result<Box<dyn LinearMemory + 'static>, MemoryError>
Copies this memory to a new memory
Trait Implementations§
source§impl From<Box<dyn LinearMemory>> for VMMemory
impl From<Box<dyn LinearMemory>> for VMMemory
source§fn from(mem: Box<dyn LinearMemory + 'static>) -> Self
fn from(mem: Box<dyn LinearMemory + 'static>) -> Self
source§impl From<VMOwnedMemory> for VMMemory
impl From<VMOwnedMemory> for VMMemory
source§fn from(mem: VMOwnedMemory) -> Self
fn from(mem: VMOwnedMemory) -> Self
source§fn from(mem: VMSharedMemory) -> Self
fn from(mem: VMSharedMemory) -> Self
source§impl LinearMemory for VMMemory
impl LinearMemory for VMMemory
source§fn grow(&mut self, delta: Pages) -> Result<Pages, MemoryError>
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.
source§fn grow_at_least(&mut self, min_size: u64) -> Result<(), MemoryError>
fn grow_at_least(&mut self, min_size: u64) -> Result<(), MemoryError>
Grows the memory to at least a minimum size. If the memory is already big enough for the min size then this function does nothing
source§fn style(&self) -> MemoryStyle
fn style(&self) -> MemoryStyle
Returns the memory style for this memory.
source§fn vmmemory(&self) -> NonNull<VMMemoryDefinition>
fn vmmemory(&self) -> NonNull<VMMemoryDefinition>
Return a VMMemoryDefinition
for exposing the memory to compiled wasm code.
source§fn try_clone(&self) -> Result<Box<dyn LinearMemory + 'static>, MemoryError>
fn try_clone(&self) -> Result<Box<dyn LinearMemory + 'static>, MemoryError>
Attempts to clone this memory (if its clonable)
source§fn copy(&mut self) -> Result<Box<dyn LinearMemory + 'static>, MemoryError>
fn copy(&mut self) -> Result<Box<dyn LinearMemory + 'static>, MemoryError>
Copies this memory to a new memory
source§fn do_notify(&mut self, dst: NotifyLocation, count: u32) -> u32
fn do_notify(&mut self, dst: NotifyLocation, count: u32) -> u32
Notify waiters from the wait list. Return the number of waiters notified