Struct ImportModule

pub struct ImportModule<T: ?Sized> { /* private fields */ }

An ImportModule represents a host module with a name. A host module consists of one or more host function, table, memory, and global instances, which are defined outside wasm modules and fed into wasm modules as imports.

Implementations

impl<T: Sized> ImportModule<T>

pub fn create(name: impl AsRef<str>, data: Box<T>) -> WasmEdgeResult<Self>

Creates a module instance which is used to import host functions, tables, memories, and globals into a wasm module.

Argument

• name - The name of the import module instance.

• data - The host context data used in this function.

Error

If fail to create the import module instance, then an error is returned.

pub unsafe fn as_raw(&self) -> *mut WasmEdge_ModuleInstanceContext

Safety

Provides a raw pointer to the inner module instance context. The lifetime of the returned pointer must not exceed that of the object itself.

pub unsafe fn from_raw(ctx: *mut WasmEdge_ModuleInstanceContext) -> Self

Safety

This function will take over the lifetime management of ctx, so do not call ffi::WasmEdge_ModuleInstanceDelete on ctx after this.

pub fn get_host_data(&self) -> &T

pub fn get_host_data_mut(&mut self) -> &mut T

impl<T: Sized> ImportModule<T>

pub fn add_func(&mut self, name: impl AsRef<str>, func: Function)

pub fn add_table(&mut self, name: impl AsRef<str>, table: Table)

pub fn add_memory(&mut self, name: impl AsRef<str>, memory: Memory)

pub fn add_global(&mut self, name: impl AsRef<str>, global: Global)

Trait Implementations

impl<T: Sized> AsInstance for ImportModule<T>

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

Safety

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

Returns the name of this exported module instance.

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

where Self: Sized,

Returns the exported table instance by name.

fn get_memory_ref( &self, name: impl AsRef<str>, ) -> WasmEdgeResult<InnerRef<Memory, &Self>>

where Self: Sized,

Returns the exported memory instance by name.

fn get_memory_mut( &mut self, name: impl AsRef<str>, ) -> WasmEdgeResult<InnerRef<Memory, &mut Self>>

where Self: Sized,

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

where Self: Sized,

Returns the exported global instance by name.

fn get_global_mut( &mut self, name: impl AsRef<str>, ) -> WasmEdgeResult<InnerRef<Global, &mut Self>>

where Self: Sized,

fn func_len(&self) -> u32

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

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

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

fn get_func(&self, name: &str) -> WasmEdgeResult<FuncRef<&Instance>>

Returns the exported function instance by name.

fn get_func_mut(&mut self, name: &str) -> WasmEdgeResult<FuncRef<&mut Instance>>

Returns the exported function instance by name.

fn table_len(&self) -> u32

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

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

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

fn mem_len(&self) -> u32

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

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

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

fn global_len(&self) -> u32

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

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

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

impl<T: Send> AsMut<ImportModule<T>> for AsyncImportObject<T>

Available on crate feature async and Linux only.

fn as_mut(&mut self) -> &mut ImportModule<T>

Converts this type into a mutable reference of the (usually inferred) input type.

impl<T: Send> AsRef<ImportModule<T>> for AsyncImportObject<T>

Available on crate feature async and Linux only.

fn as_ref(&self) -> &ImportModule<T>

Converts this type into a shared reference of the (usually inferred) input type.

impl<T: Debug + ?Sized> Debug for ImportModule<T>

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

Formats the value using the given formatter.

impl<T: ?Sized> Drop for ImportModule<T>

fn drop(&mut self)

Executes the destructor for this type.