Struct wasmer_compiler_cranelift::translator::func_translator::FuncTranslator

pub struct FuncTranslator {
    func_ctx: FunctionBuilderContext,
    state: FuncTranslationState,
}

WebAssembly to Cranelift IR function translator.

A FuncTranslator is used to translate a binary WebAssembly function into Cranelift IR guided by a FuncEnvironment object. A single translator instance can be reused to translate multiple functions which will reduce heap allocation traffic.

Fields

func_ctx: FunctionBuilderContext

state: FuncTranslationState

Implementations

impl FuncTranslator

pub fn new() -> Self

Create a new translator.

pub fn translate<FE: FuncEnvironment + ?Sized>( &mut self, module_translation_state: &ModuleTranslationState, reader: &mut dyn FunctionBinaryReader<'_>, func: &mut Function, environ: &mut FE, local_function_index: LocalFunctionIndex, ) -> WasmResult<()>

Translate a binary WebAssembly function.

The code slice contains the binary WebAssembly function code as it appears in the code section of a WebAssembly module, not including the initial size of the function code. The slice is expected to contain two parts:

• The declaration of locals, and
• The function body as an expression.

See the WebAssembly specification.

The Cranelift IR function func should be completely empty except for the func.signature and func.name fields. The signature may contain special-purpose arguments which are not regarded as WebAssembly local variables. Any signature arguments marked as ArgumentPurpose::Normal are made accessible as WebAssembly local variables.

pub fn translate_from_reader<FE: FuncEnvironment + ?Sized>( &mut self, module_translation_state: &ModuleTranslationState, reader: &mut dyn FunctionBinaryReader<'_>, func: &mut Function, environ: &mut FE, ) -> WasmResult<()>

Translate a binary WebAssembly function from a FunctionBinaryReader.