Struct susywasmi::Module

pub struct Module { /* fields omitted */ }

Deserialized module prepared for instantiation.

Methods

impl Module

pub fn from_susywasm_module(module: Module) -> Result<Module, Error>

Create Module from susywasm::elements::Module.

This function will load, validate and prepare a susywasm's Module.

Errors

Returns Err if provided Module is not valid.

Examples

extern crate susywasm;
extern crate susywasmi;

use susywasm::builder;
use susywasm::elements;

fn main() {
    let s_module =
        builder::module()
            .function()
                .signature().with_param(elements::ValueType::I32).build()
                .body().build()
            .build()
        .build();

    let module = susywasmi::Module::from_susywasm_module(s_module)
        .expect("susywasm builder generated invalid module!");

    // Instantiate `module`, etc...
}

pub fn deny_floating_point(&self) -> Result<(), Error>

Fail if the module contains any floating-point operations

Errors

Returns Err if provided Module is not valid.

Examples

let susywasm_binary: Vec<u8> =
    wabt::wat2susywasm(
        r#"
        (module
         (func $add (param $lhs i32) (param $rhs i32) (result i32)
               get_local $lhs
               get_local $rhs
               i32.add))
        "#,
    )
    .expect("failed to parse wat");

// Load susywasm binary and prepare it for instantiation.
let module = susywasmi::Module::from_buffer(&susywasm_binary).expect("Parsing failed");
assert!(module.deny_floating_point().is_ok());

let susywasm_binary: Vec<u8> =
    wabt::wat2susywasm(
        r#"
        (module
         (func $add (param $lhs f32) (param $rhs f32) (result f32)
               get_local $lhs
               get_local $rhs
               f32.add))
        "#,
    )
    .expect("failed to parse wat");

let module = susywasmi::Module::from_buffer(&susywasm_binary).expect("Parsing failed");
assert!(module.deny_floating_point().is_err());

let susywasm_binary: Vec<u8> =
    wabt::wat2susywasm(
        r#"
        (module
         (func $add (param $lhs f32) (param $rhs f32) (result f32)
               get_local $lhs))
        "#,
    )
    .expect("failed to parse wat");

let module = susywasmi::Module::from_buffer(&susywasm_binary).expect("Parsing failed");
assert!(module.deny_floating_point().is_err());

pub fn from_buffer<B: AsRef<[u8]>>(buffer: B) -> Result<Module, Error>

Create Module from a given buffer.

This function will deserialize susywasm module from a given module, validate and prepare it for instantiation.

Errors

Returns Err if susywasm binary in provided buffer is not valid susywasm binary.

Examples

extern crate susywasmi;

fn main() {
    let module =
        susywasmi::Module::from_buffer(
            // Minimal module:
            //   \0asm - magic
            //    0x01 - version (in little-endian)
            &[0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00]
        ).expect("Failed to load minimal module");

    // Instantiate `module`, etc...
}