Struct wasmi::GlobalInstance

pub struct GlobalInstance { /* fields omitted */ }

Runtime representation of a global variable (or global for short).

Global contains a value of a specified type and flag which specifies whether this global are mutable or immutable. Neither type of the value nor immutability can't be changed after creation.

Attempt to change value of immutable global or to change type of the value (e.g. assign I32 value to a global that was created with I64 type) will lead to an error.

Implementations

impl GlobalInstance

pub fn alloc(val: RuntimeValue, mutable: bool) -> GlobalRef

Allocate a global variable instance.

Since it is possible to export only immutable globals, users likely want to set mutable to false.

pub fn set(&self, val: RuntimeValue) -> Result<(), Error>

Change the value of this global variable.

Errors

Returns Err if this global isn't mutable or if type of val doesn't match global's type.

pub fn get(&self) -> RuntimeValue

Get the value of this global variable.

pub fn is_mutable(&self) -> bool

Returns if this global variable is mutable.

Note: Imported and/or exported globals are always immutable.

pub fn value_type(&self) -> ValueType

Returns value type of this global variable.

Trait Implementations

impl Debug for GlobalInstance

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

Formats the value using the given formatter.