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 and retains the backing claim. A replacement runtime is refused until every handle releases it. Custom backing identities must follow super::MemoryBacking; raw aliased access remains prohibited. 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. Size, valid IO, and growth check the complete bounded manager metadata before using cached translations. Detected divergence permanently poisons this owner. Invalid IO bounds still refuse before backing access. These checks add bounded metadata reads, not ledger/payload decoding or synchronization with raw aliases.

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 verifies metadata and returns the current extent without growth or writes, 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.