Struct ImportEntry 

pub struct ImportEntry { /* private fields */ }

Import entry.

Implementations

impl ImportEntry

pub fn new(module_str: String, field_str: String, external: External) -> Self

New import entry.

pub fn module(&self) -> &str

Module reference of the import entry.

Examples found in repository

examples/info.rs (line 21)

fn main() {
    let args = env::args().collect::<Vec<_>>();
    if args.len() != 2 {
        println!("Usage: {} somefile.wasm", args[0]);
        return;
    }

    let module = sophon_wasm::deserialize_file(&args[1]).expect("Failed to load module");

    println!("Module sections: {}", module.sections().len());

    for section in module.sections() {
        match *section {
            Section::Import(ref import_section) => {
                println!("  Imports: {}", import_section.entries().len());
                import_section.entries().iter().map(|e| println!("    {}.{}", e.module(), e.field())).count();
            },
            Section::Export(ref exports_section) => {
                println!("  Exports: {}", exports_section.entries().len());
                exports_section.entries().iter().map(|e| println!("    {}", e.field())).count();
            },            
            Section::Function(ref function_section) => {
                println!("  Functions: {}", function_section.entries().len());
            },
            Section::Type(ref type_section) => {
                println!("  Types: {}", type_section.types().len());
            },
            Section::Global(ref globals_section) => {
                println!("  Globals: {}", globals_section.entries().len());                
            },
            Section::Data(ref data_section) if data_section.entries().len() > 0 => {
                let data = &data_section.entries()[0];
                println!("  Data size: {}", data.value().len()); 
            },
            _ => {},
        }
    }
}

pub fn module_mut(&mut self) -> &mut String

Module reference of the import entry (mutable).

pub fn field(&self) -> &str

Field reference of the import entry.

Examples found in repository

examples/info.rs (line 21)

fn main() {
    let args = env::args().collect::<Vec<_>>();
    if args.len() != 2 {
        println!("Usage: {} somefile.wasm", args[0]);
        return;
    }

    let module = sophon_wasm::deserialize_file(&args[1]).expect("Failed to load module");

    println!("Module sections: {}", module.sections().len());

    for section in module.sections() {
        match *section {
            Section::Import(ref import_section) => {
                println!("  Imports: {}", import_section.entries().len());
                import_section.entries().iter().map(|e| println!("    {}.{}", e.module(), e.field())).count();
            },
            Section::Export(ref exports_section) => {
                println!("  Exports: {}", exports_section.entries().len());
                exports_section.entries().iter().map(|e| println!("    {}", e.field())).count();
            },            
            Section::Function(ref function_section) => {
                println!("  Functions: {}", function_section.entries().len());
            },
            Section::Type(ref type_section) => {
                println!("  Types: {}", type_section.types().len());
            },
            Section::Global(ref globals_section) => {
                println!("  Globals: {}", globals_section.entries().len());                
            },
            Section::Data(ref data_section) if data_section.entries().len() > 0 => {
                let data = &data_section.entries()[0];
                println!("  Data size: {}", data.value().len()); 
            },
            _ => {},
        }
    }
}

pub fn field_mut(&mut self) -> &mut String

Field reference of the import entry (mutable)

pub fn external(&self) -> &External

Local binidng of the import entry.

Examples found in repository

examples/exports.rs (line 24)

fn type_by_index(module: &Module, index: usize) -> FunctionType {

    // Demand that function and type section exist. Otherwise, fail with a
    // corresponding error.
    let function_section = module.function_section().expect("No function section found");
    let type_section = module.type_section().expect("No type section found");

    // This counts the number of _function_ imports listed by the module, excluding
    // the globals, since indexing for actual functions for `call` and `export` purposes
    // includes both imported and own functions. So we actualy need the imported function count
    // to resolve actual index of the given function in own functions list.
    let import_section_len: usize = match module.import_section() {
            Some(import) =>
                import.entries().iter().filter(|entry| match entry.external() {
                    &External::Function(_) => true,
                    _ => false,
                    }).count(),
            None => 0,
        };

    // Substract the value queried in the previous step from the provided index
    // to get own function index from which we can query type next.
    let function_index_in_section = index - import_section_len;

    // Query the own function given we have it's index
    let func_type_ref: usize = function_section.entries()[function_index_in_section].type_ref() as usize;

    // Finally, return function type (signature)
    match type_section.types()[func_type_ref] {
        Type::Function(ref func_type) => func_type.clone(),
    }
}

examples/invoke.rs (line 47)

fn main() {
    let args: Vec<_> = args().collect();
    if args.len() < 3 {
        println!("Usage: {} <wasm file> <exported func> [<arg>...]", args[0]);
        return;
    }
    let func_name = &args[2];
    let (_, program_args) = args.split_at(3);

    // Intrepreter initialization.
    let program = sophon_wasm::ProgramInstance::new();

    let module = sophon_wasm::deserialize_file(&args[1]).expect("File to be deserialized");

    // Extracts call arguments from command-line arguments
    let execution_params = {
        // Export section has an entry with a func_name with an index inside a module
        let export_section = module.export_section().expect("No export section found");
        // It's a section with function declarations (which are references to the type section entries)
        let function_section = module.function_section().expect("No function section found");
        // Type section stores function types which are referenced by function_section entries
        let type_section = module.type_section().expect("No type section found");

        // Given function name used to find export section entry which contains
        // an `internal` field which points to the index in the function index space
        let found_entry = export_section.entries().iter()
            .find(|entry| func_name == entry.field()).expect(&format!("No export with name {} found", func_name));

        // Function index in the function index space (internally-defined + imported)
        let function_index: usize = match found_entry.internal() {
            &Internal::Function(index) => index as usize,
            _ => panic!("Founded export is not a function"),
        };

        // We need to count import section entries (functions only!) to subtract it from function_index
        // and obtain the index within the function section
        let import_section_len: usize = match module.import_section() {
            Some(import) =>
                import.entries().iter().filter(|entry| match entry.external() {
                    &External::Function(_) => true,
                    _ => false,
                    }).count(),
            None => 0,
        };

        // Calculates a function index within module's function section
        let function_index_in_section = function_index - import_section_len;

        // Getting a type reference from a function section entry
        let func_type_ref: usize = function_section.entries()[function_index_in_section].type_ref() as usize;

        // Use the reference to get an actual function type
        let function_type: &FunctionType = match &type_section.types()[func_type_ref] {
            &Type::Function(ref func_type) => func_type,
        };

        // Parses arguments and constructs runtime values in correspondence of their types
        let args: Vec<RuntimeValue> = function_type.params().iter().enumerate().map(|(i, value)| match value {
            &ValueType::I32 => RuntimeValue::I32(program_args[i].parse::<i32>().expect(&format!("Can't parse arg #{} as i32", program_args[i]))),
            &ValueType::I64 => RuntimeValue::I64(program_args[i].parse::<i64>().expect(&format!("Can't parse arg #{} as i64", program_args[i]))),
            &ValueType::F32 => RuntimeValue::F32(program_args[i].parse::<f32>().expect(&format!("Can't parse arg #{} as f32", program_args[i]))),
            &ValueType::F64 => RuntimeValue::F64(program_args[i].parse::<f64>().expect(&format!("Can't parse arg #{} as f64", program_args[i]))),
        }).collect();

        interpreter::ExecutionParams::from(args)
    };

    // Intialize deserialized module. It adds module into It expects 3 parameters:
    // - a name for the module
    // - a module declaration
    // - "main" module doesn't import native module(s) this is why we don't need to provide external native modules here
    // This test shows how to implement native module https://github.com/NikVolf/sophon-wasm/blob/master/src/interpreter/tests/basics.rs#L197
    let module = program.add_module("main", module, None).expect("Failed to initialize module");

    println!("Result: {:?}", module.execute_export(func_name, execution_params).expect(""));
}

pub fn external_mut(&mut self) -> &mut External

Local binidng of the import entry (mutable)

Trait Implementations

impl Clone for ImportEntry

fn clone(&self) -> ImportEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImportEntry

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

Formats the value using the given formatter.

impl Deserialize for ImportEntry

type Error = Error

Serialization error produced by deserialization routine.

fn deserialize<R: Read>(reader: &mut R) -> Result<Self, Self::Error>

Deserialize type from serial i/o

impl Serialize for ImportEntry

type Error = Error

Serialization error produced by serialization routine.

fn serialize<W: Write>(self, writer: &mut W) -> Result<(), Self::Error>

Serialize type to serial i/o