Struct wasmedge_sdk::Store

pub struct Store { /* private fields */ }

Represents all global state that can be manipulated by WebAssembly programs. A store consists of the runtime representation of all instances of functions, tables, memories, and globals.

Implementations

impl Store

pub fn new() -> WasmEdgeResult<Self>

Creates a new Store.

Error

If fail to create a new Store, then an error is returned.

pub fn register_import_module(
    &mut self,
    executor: &mut Executor,
    import: &ImportObject
) -> WasmEdgeResult<()>

Registers and instantiates a WasmEdge import object into this store.

Arguments

• executor - The executor that runs the host functions in this store.

• import - The WasmEdge import object to be registered.

Error

If fail to register the given import object, then an error is returned.

pub fn register_named_module(
    &mut self,
    executor: &mut Executor,
    mod_name: impl AsRef<str>,
    module: &Module
) -> WasmEdgeResult<Instance>

Registers and instantiates a WasmEdge compiled module into this store as a named module instance, and returns the module instance.

Instantiates the given WasmEdge compiled module, including the functions, memories, tables, and globals it hosts; and then, registers the module instance into the store with the given name.

Arguments

• executor - The executor that runs the host functions in this store.

• mod_name - The exported name of the registered module.

• module - The validated module to be registered.

Error

If fail to register the given module, then an error is returned.

pub fn register_active_module(
    &mut self,
    executor: &mut Executor,
    module: &Module
) -> WasmEdgeResult<Instance>

Registers and instantiates a WasmEdge compiled module into this store as an anonymous active module instance, and returns the module instance.

Arguments

• executor - The executor that runs the host functions in this store.

• module - The validated module to be registered.

Error

If fail to register the given module, then an error is returned.

pub fn named_instance_count(&self) -> u32

Returns the number of the named module instances in this store.

pub fn instance_names(&self) -> Vec<String>

Returns the names of all registered named module instances.

pub fn named_instance(
    &mut self,
    name: impl AsRef<str>
) -> WasmEdgeResult<Instance>

Returns the named module instance with the given name.

Argument

• name - The name of the target module instance to be returned.

pub fn contains(&self, mod_name: impl AsRef<str>) -> bool

Checks if the store contains a named module instance.

Argument

• mod_name - The name of the named module.

Trait Implementations

impl Clone for Store

fn clone(&self) -> Store

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Store

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

Formats the value using the given formatter.