Struct wasmer_runtime_core::instance::Instance

pub struct Instance { /* fields omitted */ }

An instantiated WebAssembly module.

An Instance represents a WebAssembly module that has been instantiated with an ImportObject and is ready to be called.

Methods

impl Instance

pub fn func<Args, Rets>(
    &self,
    name: &str
) -> ResolveResult<Func<Args, Rets, Wasm>> where
    Args: WasmTypeList,
    Rets: WasmTypeList, 

Through generic magic and the awe-inspiring power of traits, we bring you...

"Func"

A Func allows you to call functions exported from wasm with near zero overhead.

Usage:

let func: Func<(i32, i32)> = instance.func("foo")?;

func.call(42, 43);

pub fn dyn_func(&self, name: &str) -> ResolveResult<DynFunc>

This returns the representation of a function that can be called safely.

Usage:

instance
    .dyn_func("foo")?
    .call(&[])?;

pub fn call(&self, name: &str, params: &[Value]) -> CallResult<Vec<Value>>

Call an exported webassembly function given the export name. Pass arguments by wrapping each one in the Value enum. The returned values are also each wrapped in a Value.

Note:

This returns CallResult<Vec<Value>> in order to support the future multi-value returns webassembly feature.

Usage:

// ...
let results = instance.call("foo", &[Value::I32(42)])?;
// ...

pub fn context(&self) -> &Ctx

Returns an immutable reference to the Ctx used by this Instance.

pub fn context_mut(&mut self) -> &mut Ctx

Returns a mutable reference to the Ctx used by this Instance.

Important traits for ExportIter<'a>

impl<'a> Iterator for ExportIter<'a> type Item = (String, Export);

pub fn exports(&self) -> ExportIter

Returns an iterator over all of the items exported from this instance.

pub fn module(&self) -> Module

The module used to instantiate this Instance.

Trait Implementations

impl LikeNamespace for Instance

fn get_export(&self, name: &str) -> Option<Export>

fn get_exports(&self) -> Vec<(String, Export)>

fn maybe_insert(&mut self, _name: &str, _export: Export) -> Option<()>