Struct Imports

pub struct Imports { /* private fields */ }

Imports for a module instance

This is used to link a module instance to its imports

Example

use tinywasm::{Imports, Extern};
use tinywasm::types::{ValType, TableType, MemoryType, WasmValue};
let mut imports = Imports::new();

// function args can be either a single
// value that implements `TryFrom<WasmValue>` or a tuple of them
let print_i32 = Extern::typed_func(|_ctx: tinywasm::FuncContext<'_>, arg: i32| {
    log::debug!("print_i32: {}", arg);
    Ok(())
});

let table_type = TableType::new(ValType::RefFunc, 10, Some(20));
let table_init = WasmValue::default_for(ValType::RefFunc);

imports
    .define("my_module", "print_i32", print_i32)?
    .define("my_module", "table", Extern::table(table_type, table_init))?
    .define("my_module", "memory", Extern::memory(MemoryType::new_32(1, Some(2))))?
    .define("my_module", "global_i32", Extern::global(WasmValue::I32(666), false))?
    .link_module("my_other_module", 0)?;

Note that module instance addresses for Imports::link_module can be obtained from crate::ModuleInstance::id. Now, the imports object can be passed to crate::ModuleInstance::instantiate.

Implementations

impl Imports

pub fn new() -> Self

Create a new empty import set

pub fn merge(self, other: Self) -> Self

Merge two import sets

pub fn link_module( &mut self, name: &str, addr: ModuleInstanceAddr, ) -> Result<&mut Self>

Link a module

This will automatically link all imported values on instantiation

pub fn define( &mut self, module: &str, name: &str, value: Extern, ) -> Result<&mut Self>

Define an import

Trait Implementations

impl Clone for Imports

fn clone(&self) -> Imports

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Imports

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

Formats the value using the given formatter.

impl Default for Imports

fn default() -> Imports

Returns the “default value” for a type.