Struct wasmedge_sys::Instance

pub struct Instance { /* private fields */ }

An Instance represents an instantiated module. In the instantiation process, An Instance is created from alModule. From an Instance the exported functions, tables, memories, and globals can be fetched.

Implementations

impl Instance

pub fn name(&self) -> Option<String>

Returns the name of this exported module instance.

If this module instance is an active module instance, then None is returned.

pub fn get_func(&self, name: impl AsRef<str>) -> WasmEdgeResult<Function>

Returns the exported function instance by name.

Argument

• name - The name of the target exported function instance.

Error

If fail to find the target function, then an error is returned.

pub fn get_table(&self, name: impl AsRef<str>) -> WasmEdgeResult<Table>

Returns the exported table instance by name.

Argument

• name - The name of the target exported table instance.

Error

If fail to find the target table instance, then an error is returned.

pub fn get_memory(&self, name: impl AsRef<str>) -> WasmEdgeResult<Memory>

Returns the exported memory instance by name.

Argument

• name - The name of the target exported memory instance.

Error

If fail to find the target memory instance, then an error is returned.

pub fn get_global(&self, name: impl AsRef<str>) -> WasmEdgeResult<Global>

Returns the exported global instance by name.

Argument

• name - The name of the target exported global instance.

Error

If fail to find the target global instance, then an error is returned.

pub fn func_len(&self) -> u32

Returns the length of the exported function instances in this module instance.

pub fn func_names(&self) -> Option<Vec<String>>

Returns the names of the exported function instances in this module instance.

pub fn table_len(&self) -> u32

Returns the length of the exported table instances in this module instance.

pub fn table_names(&self) -> Option<Vec<String>>

Returns the names of the exported table instances in this module instance.

pub fn mem_len(&self) -> u32

Returns the length of the exported memory instances in this module instance.

pub fn mem_names(&self) -> Option<Vec<String>>

Returns the names of all exported memory instances in this module instance.

pub fn global_len(&self) -> u32

Returns the length of the exported global instances in this module instance.

pub fn global_names(&self) -> Option<Vec<String>>

Returns the names of the exported global instances in this module instance.

pub fn host_data<T: Send + Sync + Clone>(&mut self) -> Option<&mut T>

Returns the host data held by the module instance.

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

Available on crate feature ffi only.

Provides a raw pointer to the inner module instance context.

Trait Implementations

impl Clone for Instance

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Instance

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

Formats the value using the given formatter.

impl Drop for Instance

fn drop(&mut self)

Executes the destructor for this type.