Struct RuntimeMemory 

pub struct RuntimeMemory<M: Memory> { /* private fields */ }

RuntimeMemory

Exclusive virtual memory leased through a runtime’s committed authority. Implements Memory for stable structures without exposing the backing memory or an alternate manager. The lease cannot be cloned; dropping it permits another open of the same allocation. Moving it into a collection transfers the lease until that collection releases the memory. The handle can outlive its runtime. Hosts must not construct another runtime or access aliased backing while any runtime or lease for that backing lives. IO checks the virtual extent before upstream bucket translation. Empty IO is valid at the end of memory, but not beyond it. Reads preserve the upstream optimized support for uninitialized destinations through Memory::read_unsafe. Growth reserves physical capacity before assigning manager buckets. Ordinary backing refusal, arithmetic overflow and bucket exhaustion return typed errors without changing virtual extents or manager metadata. Backing implementations must obey the Memory contract; traps and partial writes are not transactions on native memory. Typed collections retain their own failure behavior.

Implementations

impl<M: Memory> RuntimeMemory<M>

pub fn grow(&self, pages: u64) -> Result<u64, RuntimeGrowError>

Grow by the requested pages, returning the previous virtual page count.

Capacity is reserved before assigning manager buckets. Ordinary refusal preserves virtual extents and manager metadata and permits retry. The upstream Memory::grow adapter translates errors into its required -1 sentinel; direct runtime callers receive super::RuntimeGrowError. A zero-page request returns the current extent without backing IO or manager mutation, after checking for reentrant growth.

Panics

Panics if a private growth-accounting invariant is broken or backing memory panics.

Trait Implementations

impl<M: Memory> Drop for RuntimeMemory<M>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl<M: Memory> Memory for RuntimeMemory<M>

fn size(&self) -> u64

Returns the current size of the memory in WebAssembly pages.

fn grow(&self, pages: u64) -> i64

Grows the memory by pages pages filled with zeroes.

fn read(&self, offset: u64, dst: &mut [u8])

Copies dst.len() bytes from memory starting at offset into dst.

unsafe fn read_unsafe(&self, offset: u64, dst: *mut u8, count: usize)

Unsafe variant of read for advanced use.

fn write(&self, offset: u64, src: &[u8])

Copies src.len() bytes from src into memory starting at offset.