Struct wasmedge_sys::Executor

pub struct Executor { /* private fields */ }

Defines an execution environment for both pure WASM and compiled WASM.

Implementations

impl Executor

pub fn create(
    config: Option<&Config>,
    stat: Option<&mut Statistics>
) -> WasmEdgeResult<Self>

Creates a new executor to be associated with the given config and statistics.

Arguments

• config - The configuration of the new executor.

• stat - The statistics needed by the new executor.

Error

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

pub fn register_import_object(
    &mut self,
    store: &mut Store,
    import: &ImportObject
) -> WasmEdgeResult<()>

Registers and instantiates a WasmEdge import object into a store.

Arguments

• store - The target store, into which the given import object is registered.

• 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,
    store: &mut Store,
    module: &Module,
    name: impl AsRef<str>
) -> WasmEdgeResult<Instance>

Registers and instantiates a WasmEdge module into a store.

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

Arguments

• store - The target store, into which the given module is registered.

• module - A validated module to be registered.

• name - The exported name of the registered module.

Error

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

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

Registers and instantiates a WasmEdge module into a store as an anonymous module.

Notice that when a new module is instantiated into the store, the old instantiated module is removed; in addition, ensure that the imports the module depends are already registered into the store.

Arguments

• store - The store, in which the module to be instantiated is stored.

• ast_mod - The target module to be instantiated.

Error

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

pub fn register_plugin_instance(
    &mut self,
    store: &mut Store,
    instance: &Instance
) -> WasmEdgeResult<()>

Registers plugin module instance into a store.

Arguments

• store - The store, in which the module to be instantiated is stored.

• instance - The plugin module instance to be registered.

Error

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

pub fn call_func(
    &self,
    func: &Function,
    params: impl IntoIterator<Item = WasmValue>
) -> WasmEdgeResult<Vec<WasmValue>>

Runs a host function instance and returns the results.

Arguments

• func - The function instance to run.

• params - The arguments to pass to the function.

Errors

If fail to run the host function, then an error is returned.

pub async fn call_func_async(
    &self,
    func: &Function,
    params: impl IntoIterator<Item = WasmValue> + Send
) -> WasmEdgeResult<Vec<WasmValue>>

Asynchronously runs a host function instance and returns the results.

Arguments

• func - The function instance to run.

• params - The arguments to pass to the function.

Errors

If fail to run the host function, then an error is returned.

pub fn call_func_ref(
    &self,
    func_ref: &FuncRef,
    params: impl IntoIterator<Item = WasmValue>
) -> WasmEdgeResult<Vec<WasmValue>>

Runs a host function reference instance and returns the results.

Arguments

• func_ref - The function reference instance to run.

• params - The arguments to pass to the function.

Errors

If fail to run the host function reference instance, then an error is returned.

pub async fn call_func_ref_async(
    &self,
    func_ref: &FuncRef,
    params: impl IntoIterator<Item = WasmValue> + Send
) -> WasmEdgeResult<Vec<WasmValue>>

Asynchronously runs a host function reference instance and returns the results.

Arguments

• func_ref - The function reference instance to run.

• params - The arguments to pass to the function.

Errors

If fail to run the host function reference instance, then an error is returned.

pub fn as_ptr(&self) -> *const WasmEdge_ExecutorContext

Provides a raw pointer to the inner Executor context.

Trait Implementations

impl Clone for Executor

fn clone(&self) -> Executor

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Executor

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

Formats the value using the given formatter.

impl Drop for Executor

fn drop(&mut self)

Executes the destructor for this type.

impl Engine for Executor

fn run_func(
    &self,
    func: &Function,
    params: impl IntoIterator<Item = WasmValue>
) -> WasmEdgeResult<Vec<WasmValue>>

Runs a host function instance and returns the results.

fn run_func_ref(
    &self,
    func_ref: &FuncRef,
    params: impl IntoIterator<Item = WasmValue>
) -> WasmEdgeResult<Vec<WasmValue>>

Runs a host function instance by calling its reference and returns the results.