Struct Store

pub struct Store {
    pub(crate) inner: Box<StoreInner>,
}

The store represents all global state that can be manipulated by WebAssembly programs. It consists of the runtime representation of all instances of functions, tables, memories, and globals that have been allocated during the lifetime of the abstract machine.

The Store is tied to the underlying Engine that is — among many things — used to compile the Wasm bytes into a valid module artifact.

For more informations, check out the [related WebAssembly specification] [related WebAssembly specification]: https://webassembly.github.io/spec/core/exec/runtime.html#store

Fields

inner: Box<StoreInner>

Implementations

impl Store

pub fn new(engine: impl Into<Engine>) -> Self

Creates a new Store with a specific Engine.

pub fn set_trap_handler(&mut self, handler: Option<Box<TrapHandlerFn<'static>>>)

Set the TrapHandlerFn for this store.

Note

Not every implementor allows changing the trap handler. In those store that don’t allow it, this function has no effect.

pub fn engine(&self) -> &Engine

Returns the Engine.

pub fn engine_mut(&mut self) -> &mut Engine

Returns mutable reference to Engine.

pub fn same(a: &Self, b: &Self) -> bool

Checks whether two stores are identical. A store is considered equal to another store if both have the same engine.

pub fn id(&self) -> StoreId

Returns the ID of this store

impl Store

pub(crate) fn into_sys(self) -> Store

Consume self into crate::backend::sys::store::Store.

pub(crate) fn as_sys(&self) -> &Store

Convert a reference to self into a reference crate::backend::sys::store::Store.

pub(crate) fn as_sys_mut(&mut self) -> &mut Store

Convert a mutable reference to self into a mutable reference crate::backend::sys::store::Store.

pub fn is_sys(&self) -> bool

Return true if self is a store from the sys runtime.

Trait Implementations

impl AsEngineRef for Store

fn as_engine_ref(&self) -> EngineRef<'_>

Create an EngineRef pointing to the underlying context.

fn maybe_as_store(&self) -> Option<StoreRef<'_>>

Create a StoreRef.

impl AsStoreMut for Store

fn as_store_mut(&mut self) -> StoreMut<'_>

Returns a StoreMut pointing to the underlying context.

fn objects_mut(&mut self) -> &mut StoreObjects

Returns the ObjectMutable

impl AsStoreRef for Store

fn as_store_ref(&self) -> StoreRef<'_>

Returns a StoreRef pointing to the underlying context.

impl Debug for Store

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

Formats the value using the given formatter.

impl Default for Store

fn default() -> Self

Returns the “default value” for a type.

impl NativeStoreExt for Store

fn signal_handler(&self) -> Option<*const TrapHandlerFn<'static>>

The signal handler

fn set_trap_handler(&mut self, handler: Option<Box<TrapHandlerFn<'static>>>)

Sets the trap handler

impl PartialEq for Store

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Send for Store

impl Sync for Store