Struct Config 

pub struct Config { /* private fields */ }

Configuration for an Engine.

Implementations

impl Config

pub fn set_stack_limits(&mut self, limits: StackLimits) -> &mut Self

👎Deprecated since 0.51.0: use Config::set_{min,max}_stack_height, Config::max_recursion_depth instead

Sets the StackLimits for the Config.

pub fn set_cached_stacks(&mut self, amount: usize) -> &mut Self

👎Deprecated since 0.51.0: use Config::set_max_cached_stacks instead

Sets the maximum amount of cached stacks for reuse for the Config.

Note

Defaults to 2.

pub fn set_max_recursion_depth(&mut self, value: usize) -> &mut Self

Sets the maximum recursion depth of the Engine’s stack during execution.

Note

An execution traps if it exceeds this limits.

pub fn set_min_stack_height(&mut self, value: usize) -> &mut Self

Sets the minimum (or initial) height of the Engine’s value stack in bytes.

Note

• Lower initial heights may improve memory consumption.
• Higher initial heights may improve cold start times.

Panics

If value is greater than the current maximum height of the value stack.

pub fn set_max_stack_height(&mut self, value: usize) -> &mut Self

Sets the maximum height of the Engine’s value stack in bytes.

Note

An execution traps if it exceeds this limits.

Panics

If value is less than the current minimum height of the value stack.

pub fn set_max_cached_stacks(&mut self, value: usize) -> &mut Self

Sets the maximum number of cached stacks for reuse for the Config.

Note

• A higher value may improve execution performance.
• A lower value may improve memory consumption.

pub fn wasm_mutable_global(&mut self, enable: bool) -> &mut Self

Enable or disable the mutable-global Wasm proposal for the Config.

Note

Enabled by default.

pub fn wasm_sign_extension(&mut self, enable: bool) -> &mut Self

Enable or disable the sign-extension Wasm proposal for the Config.

Note

Enabled by default.

pub fn wasm_saturating_float_to_int(&mut self, enable: bool) -> &mut Self

Enable or disable the saturating-float-to-int Wasm proposal for the Config.

Note

Enabled by default.

pub fn wasm_multi_value(&mut self, enable: bool) -> &mut Self

Enable or disable the multi-value Wasm proposal for the Config.

Note

Enabled by default.

pub fn wasm_multi_memory(&mut self, enable: bool) -> &mut Self

Enable or disable the multi-memory Wasm proposal for the Config.

Note

Enabled by default.

pub fn wasm_bulk_memory(&mut self, enable: bool) -> &mut Self

Enable or disable the bulk-memory Wasm proposal for the Config.

Note

Enabled by default.

pub fn wasm_reference_types(&mut self, enable: bool) -> &mut Self

Enable or disable the reference-types Wasm proposal for the Config.

Note

Enabled by default.

pub fn wasm_tail_call(&mut self, enable: bool) -> &mut Self

Enable or disable the tail-call Wasm proposal for the Config.

Note

Enabled by default.

pub fn wasm_extended_const(&mut self, enable: bool) -> &mut Self

Enable or disable the extended-const Wasm proposal for the Config.

Note

Enabled by default.

pub fn wasm_custom_page_sizes(&mut self, enable: bool) -> &mut Self

Enable or disable the custom-page-sizes Wasm proposal for the Config.

Note

Disabled by default.

pub fn wasm_memory64(&mut self, enable: bool) -> &mut Self

Enable or disable the memory64 Wasm proposal for the Config.

Note

Disabled by default.

pub fn wasm_wide_arithmetic(&mut self, enable: bool) -> &mut Self

Enable or disable the wide-arithmetic Wasm proposal for the Config.

Disabled by default.

pub fn wasm_simd(&mut self, enable: bool) -> &mut Self

Enable or disable the simd Wasm proposal for the Config.

Enabled by default.

pub fn wasm_relaxed_simd(&mut self, enable: bool) -> &mut Self

Enable or disable the relaxed-simd Wasm proposal for the Config.

Enabled by default.

pub fn floats(&mut self, enable: bool) -> &mut Self

Enable or disable Wasm floating point (f32 and f64) instructions and types.

Enabled by default.

pub fn consume_fuel(&mut self, enable: bool) -> &mut Self

Configures whether Wasmi will consume fuel during execution to either halt execution as desired.

Note

This configuration can be used to make Wasmi instrument its internal bytecode so that it consumes fuel as it executes. Once an execution runs out of fuel a TrapCode::OutOfFuel trap is raised. This way users can deterministically halt or yield the execution of WebAssembly code.

• Use Store::set_fuel to set the remaining fuel of the Store before executing some code as the Store start with no fuel.
• Use Caller::set_fuel to update the remaining fuel when executing host functions.

Disabled by default.

pub fn ignore_custom_sections(&mut self, enable: bool) -> &mut Self

Configures whether Wasmi will ignore custom sections when parsing Wasm modules.

Default value: false

pub fn compilation_mode(&mut self, mode: CompilationMode) -> &mut Self

Sets the CompilationMode used for the Engine.

By default CompilationMode::LazyTranslation is used.

pub fn enforced_limits(&mut self, limits: EnforcedLimits) -> &mut Self

Sets the EnforcedLimits enforced by the Engine for Wasm module parsing and compilation.

By default no limits are enforced.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.