Struct wasmtime_runtime::InstanceHandle

pub struct InstanceHandle { /* fields omitted */ }

A handle holding an Instance of a WebAssembly module.

Methods

impl InstanceHandle

pub fn set_signal_handler<H>(&mut self, handler: H) where
    H: 'static + Fn(c_int, *const siginfo_t, *const c_void) -> bool, 

Set a custom signal handler

impl InstanceHandle

pub unsafe fn new(
    module: Arc<Module>,
    trap_registration: TrapRegistration,
    finished_functions: BoxedSlice<DefinedFuncIndex, *mut [VMFunctionBody]>,
    imports: Imports,
    data_initializers: &[DataInitializer],
    vmshared_signatures: BoxedSlice<SignatureIndex, VMSharedSignatureIndex>,
    dbg_jit_registration: Option<Rc<GdbJitImageRegistration>>,
    host_state: Box<dyn Any>
) -> Result<Self, InstantiationError>

Create a new InstanceHandle pointing at a new Instance.

Unsafety

This method is not necessarily inherently unsafe to call, but in general the APIs of an Instance are quite unsafe and have not been really audited for safety that much. As a result the unsafety here on this method is a low-overhead way of saying "this is an extremely unsafe type to work with".

Extreme care must be taken when working with InstanceHandle and it's recommended to have relatively intimate knowledge of how it works internally if you'd like to do so. If possible it's recommended to use the wasmtime crate API rather than this type since that is vetted for safety.

pub unsafe fn from_vmctx(vmctx: *mut VMContext) -> Self

Create a new InstanceHandle pointing at the instance pointed to by the given VMContext pointer.

Safety

This is unsafe because it doesn't work on just any VMContext, it must be a VMContext allocated as part of an Instance.

pub fn vmctx(&self) -> &VMContext

Return a reference to the vmctx used by compiled wasm code.

pub fn vmctx_ptr(&self) -> *mut VMContext

Return a raw pointer to the vmctx used by compiled wasm code.

pub fn module(&self) -> &Arc<Module>

Return a reference-counting pointer to a module.

pub fn module_ref(&self) -> &Module

Return a reference to a module.

pub fn lookup(&self, field: &str) -> Option<Export>

Lookup an export with the given name.

pub fn lookup_by_declaration(&self, export: &Export) -> Export

Lookup an export with the given export declaration.

pub fn exports(&self) -> Iter<String, Export>

Return an iterator over the exports of this instance.

Specifically, it provides access to the key-value pairs, where the keys are export names, and the values are export declarations which can be resolved lookup_by_declaration.

pub fn host_state(&self) -> &dyn Any

Return a reference to the custom state attached to this instance.

pub fn memory_index(&self, memory: &VMMemoryDefinition) -> DefinedMemoryIndex

Return the memory index for the given VMMemoryDefinition in this instance.

pub fn memory_grow(
    &self,
    memory_index: DefinedMemoryIndex,
    delta: u32
) -> Option<u32>

Grow memory in this instance by the specified amount of pages.

Returns None if memory can't be grown by the specified amount of pages.

pub fn table_index(&self, table: &VMTableDefinition) -> DefinedTableIndex

Return the table index for the given VMTableDefinition in this instance.

pub fn table_grow(
    &self,
    table_index: DefinedTableIndex,
    delta: u32
) -> Option<u32>

Grow table in this instance by the specified amount of pages.

Returns None if memory can't be grown by the specified amount of pages.

pub fn table_get(
    &self,
    table_index: DefinedTableIndex,
    index: u32
) -> Option<VMCallerCheckedAnyfunc>

Get table element reference.

Returns None if index is out of bounds.

pub fn table_set(
    &self,
    table_index: DefinedTableIndex,
    index: u32,
    val: VMCallerCheckedAnyfunc
) -> Result<(), ()>

Set table element reference.

Returns an error if the index is out of bounds

Trait Implementations

impl Clone for InstanceHandle

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Drop for InstanceHandle

fn drop(&mut self)

Executes the destructor for this type.

impl Eq for InstanceHandle

impl Hash for InstanceHandle

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl PartialEq<InstanceHandle> for InstanceHandle

fn eq(&self, other: &InstanceHandle) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &InstanceHandle) -> bool

This method tests for !=.

impl StructuralEq for InstanceHandle

impl StructuralPartialEq for InstanceHandle