Struct Store 

pub(crate) 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>) -> Store

Creates a new Store with a specific Engine.

pub fn set_trap_handler( &mut self, handler: Option<Box<dyn Fn(i32, *const siginfo_t, *const c_void) -> bool + Sync + Send>>, )

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: &Store, b: &Store) -> 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

pub fn interrupter(&self) -> Interrupter

Builds an Interrupter for this store. Calling Interrupter::interrupt will cause running WASM code to terminate immediately with a HostInterrupt trap.

Best effort is made to ensure interrupts are handled. However, there is no guarantee; under rare circumstances, it is possible for the interrupt to be missed. One such case is when the target thread is about to call WASM code but has not yet made the call.

To make sure the code is interrupted, the target thread should notify the signalling thread that it has finished running in some way, and the signalling thread must wait for that notification and retry the interrupt if the notification is not received after some time. Embedders are expected to implement this logic.

If an interrupt is delivered while an imported function is running, the interrupt will simply be stored and processed only when the imported function returns control to WASM code. No effort is made to interrupt running imported functions. Embedders are expected to implement support for interruption of long-running or blocking imported functions separately.

pub fn into_async(self) -> StoreAsync

Transforms this store into a StoreAsync which can be used to invoke Function::call_async.

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.

fn as_store_async(&self) -> Option<impl AsStoreAsync + 'static>

Returns a StoreAsync if the current context is asynchronous. The store will be locked since it’s already active in the current context, but can be used to spawn new coroutines via Function::call_async.

impl Debug for Store

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

Formats the value using the given formatter.

impl Default for Store

fn default() -> Store

Returns the “default value” for a type.

impl PartialEq for Store

fn eq(&self, other: &Store) -> 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