pub struct Global { /* private fields */ }
Expand description
Defines a WebAssembly global variable, which stores a single value of the given type and a flag indicating whether it is mutable or not.
Implementations§
Source§impl Global
impl Global
Sourcepub fn create(ty: &GlobalType, val: WasmValue) -> WasmEdgeResult<Self>
pub fn create(ty: &GlobalType, val: WasmValue) -> WasmEdgeResult<Self>
Creates a new Global instance to be associated with the given [GlobalType] and WasmValue.
The type of the given WasmValue must be matched with [GlobalType]; otherwise, it causes a failure. For example, WasmValue::I32(520)
conflicts with a [GlobalType] with a value type defined as ValType::F32
.
§Errors
- If fail to create the Global instance, then WasmEdgeError::Global(GlobalError::Create)(crate::error::GlobalError) is returned.
Sourcepub fn ty(&self) -> WasmEdgeResult<GlobalType>
pub fn ty(&self) -> WasmEdgeResult<GlobalType>
Sourcepub fn set_value(&mut self, val: WasmValue) -> WasmEdgeResult<()>
pub fn set_value(&mut self, val: WasmValue) -> WasmEdgeResult<()>
Sets the value of the Global instance.
Notice that only the Global instance of Mutability::Var type can be set a new value. Setting a new value for a Global of Mutability::Const causes a failure.
§Argument
val
- The new wasm value to be set.
§Errors
If fail to set value, then an error is returned.
Sourcepub unsafe fn as_ptr(&self) -> *const WasmEdge_GlobalInstanceContext
pub unsafe fn as_ptr(&self) -> *const WasmEdge_GlobalInstanceContext
§Safety
The lifetime of the returned pointer must not exceed that of the object itself.
Sourcepub unsafe fn from_raw(ptr: *mut WasmEdge_GlobalInstanceContext) -> Self
pub unsafe fn from_raw(ptr: *mut WasmEdge_GlobalInstanceContext) -> Self
§Safety
This function takes ownership of ptr
, so do not call ffi::WasmEdge_GlobalInstanceDelete
on ptr
after this.