Struct wasmer::Instance

pub struct Instance {
    pub exports: Exports,
    /* private fields */
}

A WebAssembly Instance is a stateful, executable instance of a WebAssembly Module.

Instance objects contain all the exported WebAssembly functions, memories, tables and globals that allow interacting with WebAssembly.

Spec: https://webassembly.github.io/spec/core/exec/runtime.html#module-instances

Fields

exports: Exports

The exports for an instance.

Implementations

impl Instance

pub fn new(
    store: &mut impl AsStoreMut,
    module: &Module,
    imports: &Imports
) -> Result<Self, InstantiationError>

Creates a new Instance from a WebAssembly Module and a set of imports using Imports or the imports macro helper.

let mut store = Store::default();
let env = FunctionEnv::new(&mut store, ());
let module = Module::new(&store, "(module)")?;
let imports = imports!{
  "host" => {
    "var" => Global::new(&mut store, Value::I32(2))
  }
};
let instance = Instance::new(&mut store, &module, &imports)?;

Errors

The function can return InstantiationErrors.

Those are, as defined by the spec:

• Link errors that happen when plugging the imports into the instance
• Runtime errors that happen when running the module start function.

pub fn new_by_index(
    store: &mut impl AsStoreMut,
    module: &Module,
    externs: &[Extern]
) -> Result<Self, InstantiationError>

Creates a new Instance from a WebAssembly Module and a vector of imports.

Errors

The function can return InstantiationErrors.

Those are, as defined by the spec:

• Link errors that happen when plugging the imports into the instance
• Runtime errors that happen when running the module start function.

pub fn module(&self) -> &Module

Gets the Module associated with this instance.

Trait Implementations

impl Clone for Instance

fn clone(&self) -> Instance

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.