Struct wasm3::Module

pub struct Module<'rt> { /* fields omitted */ }

A loaded module belonging to a specific runtime. Allows for linking and looking up functions.

Implementations

impl<'rt> Module<'rt>

pub fn parse<TData: Into<Box<[u8]>>>(
    environment: &Environment,
    bytes: TData
) -> Result<ParsedModule>

Parses a wasm module from raw bytes.

pub fn link_function<Args, Ret>(
    &mut self,
    module_name: &str,
    function_name: &str,
    f: RawCall
) -> Result<()> where
    Args: WasmArgs,
    Ret: WasmType, 

Links the given function to the corresponding module and function name. This allows linking a more verbose function, as it gets access to the unsafe runtime parts. For easier use the make_func_wrapper should be used to create the unsafe facade for your function that then can be passed to this.

For a simple API see link_closure which takes a closure instead.

Errors

This function will return an error in the following situations:

• a memory allocation failed
• no function by the given name in the given module could be found
• the function has been found but the signature did not match

pub fn link_closure<Args, Ret, F>(
    &mut self,
    module_name: &str,
    function_name: &str,
    closure: F
) -> Result<()> where
    Args: WasmArgs,
    Ret: WasmType,
    F: for<'cc> FnMut(CallContext<'cc>, Args) -> Result<Ret, Trap> + 'static, 

Links the given closure to the corresponding module and function name. This boxes the closure and therefor requires a heap allocation.

Errors

This function will return an error in the following situations:

• a memory allocation failed
• no function by the given name in the given module could be found
• the function has been found but the signature did not match

pub fn find_function<Args, Ret>(
    &self,
    function_name: &str
) -> Result<Function<'rt, Args, Ret>> where
    Args: WasmArgs,
    Ret: WasmType, 

Looks up a function by the given name in this module.

Errors

This function will return an error in the following situations:

• a memory allocation failed
• no function by the given name in the given module could be found
• the function has been found but the signature did not match

pub fn function<Args, Ret>(
    &self,
    function_index: usize
) -> Result<Function<'rt, Args, Ret>> where
    Args: WasmArgs,
    Ret: WasmType, 

Looks up a function by its index in this module.

Errors

This function will return an error in the following situations:

• a memory allocation failed
• the index is out of bounds
• the function has been found but the signature did not match

pub fn name(&self) -> &str

The name of this module.

pub fn link_wasi(&mut self) -> Result<()>

Links wasi to this module.