Struct wasmer::instance::Instance

pub struct Instance {
    pub(crate) _inner: Instance,
    pub(crate) module: Module,
    pub exports: Exports,
}

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

_inner: Instance

module: Module

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.

impl PartialEq for Instance

fn eq(&self, other: &Instance) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Instance

impl StructuralPartialEq for Instance