Struct wasmedge_sdk::wasi::WasiInstance

pub struct WasiInstance { /* private fields */ }

Represents a wasi module instance.

Implementations

impl WasiInstance

pub fn initialize(
    &mut self,
    args: Option<Vec<&str>>,
    envs: Option<Vec<&str>>,
    preopens: Option<Vec<&str>>
)

Initializes the WASI host module with the given parameters.

Arguments

• args - The commandline arguments. The first argument is the program name.

• envs - The environment variables in the format ENV_VAR_NAME=VALUE.

• preopens - The directories to pre-open. The required format is DIR1:DIR2.

pub fn exit_code(&self) -> u32

Returns the WASI exit code.

The WASI exit code can be accessed after running the “_start” function of a wasm32-wasi program.

pub fn native_handler(&self, fd: i32) -> WasmEdgeResult<u64>

Returns the native handler from the mapped FD/Handler.

Argument

• fd - The WASI mapped Fd.

Error

If fail to get the native handler, then an error is returned.

Trait Implementations

impl AsInstance for WasiInstance

fn name(&self) -> &str

Returns the name of this exported module instance.

If this module instance is an active instance, return None.

fn func_count(&self) -> usize

Returns the count 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 func(&self, name: impl AsRef<str>) -> WasmEdgeResult<Func>

Returns the exported function instance in this module instance by the given function name.

Argument

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

fn global_count(&self) -> usize

Returns the count 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.

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

Returns the exported global instance in this module instance by the given global name.

Argument

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

fn memory_count(&self) -> usize

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

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

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

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

Returns the exported memory instance in this module instance by the given memory name.

Argument

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

fn table_count(&self) -> usize

Returns the count 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 table(&self, name: impl AsRef<str>) -> WasmEdgeResult<Table>

Returns the exported table instance in this module instance by the given table name.

Argument

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

impl Clone for WasiInstance

fn clone(&self) -> WasiInstance

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for WasiInstance

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

Formats the value using the given formatter.