Struct wasmtime_runtime::InstanceHandle [−][src]
A handle holding an Instance
of a WebAssembly module.
Implementations
impl InstanceHandle
[src]
pub unsafe fn new(
module: Arc<Module>,
finished_functions: &PrimaryMap<DefinedFuncIndex, *mut [VMFunctionBody]>,
imports: Imports<'_>,
mem_creator: Option<&dyn RuntimeMemoryCreator>,
lookup_shared_signature: &dyn Fn(SignatureIndex) -> VMSharedSignatureIndex,
host_state: Box<dyn Any>,
interrupts: *const VMInterrupts,
externref_activations_table: *mut VMExternRefActivationsTable,
stack_map_registry: *mut StackMapRegistry
) -> Result<Self, InstantiationError>
[src]
module: Arc<Module>,
finished_functions: &PrimaryMap<DefinedFuncIndex, *mut [VMFunctionBody]>,
imports: Imports<'_>,
mem_creator: Option<&dyn RuntimeMemoryCreator>,
lookup_shared_signature: &dyn Fn(SignatureIndex) -> VMSharedSignatureIndex,
host_state: Box<dyn Any>,
interrupts: *const VMInterrupts,
externref_activations_table: *mut VMExternRefActivationsTable,
stack_map_registry: *mut StackMapRegistry
) -> 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.
It is your responsibility to ensure that the given raw
externref_activations_table
and stack_map_registry
outlive this
instance.
pub unsafe fn initialize(
&self,
is_bulk_memory: bool,
data_initializers: &[DataInitializer<'_>]
) -> Result<(), InstantiationError>
[src]
&self,
is_bulk_memory: bool,
data_initializers: &[DataInitializer<'_>]
) -> Result<(), InstantiationError>
Finishes the instantiation process started by Instance::new
.
Only safe to call immediately after instantiation.
pub unsafe fn from_vmctx(vmctx: *mut VMContext) -> Self
[src]
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
[src]
Return a reference to the vmctx used by compiled wasm code.
pub fn vmctx_ptr(&self) -> *mut VMContext
[src]
Return a raw pointer to the vmctx used by compiled wasm code.
pub fn module(&self) -> &Module
[src]
Return a reference to a module.
pub fn lookup(&self, field: &str) -> Option<Export<'_>>
[src]
Lookup an export with the given name.
pub fn lookup_by_declaration(&self, export: &EntityIndex) -> Export<'_>
[src]
Lookup an export with the given export declaration.
pub fn exports(&self) -> Iter<'_, String, EntityIndex>
[src]
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
[src]
Return a reference to the custom state attached to this instance.
pub fn memory_index(&self, memory: &VMMemoryDefinition) -> DefinedMemoryIndex
[src]
Return the memory index for the given VMMemoryDefinition
in this instance.
pub fn memory_grow(
&self,
memory_index: DefinedMemoryIndex,
delta: u32
) -> Option<u32>
[src]
&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
[src]
Return the table index for the given VMTableDefinition
in this instance.
pub fn table_grow(
&self,
table_index: TableIndex,
delta: u32,
init_value: TableElement
) -> Option<u32>
[src]
&self,
table_index: TableIndex,
delta: u32,
init_value: TableElement
) -> Option<u32>
Grow table in this instance by the specified amount of elements.
When the table is successfully grown, returns the original size of the table.
Returns None
if memory can’t be grown by the specified amount of pages
or if the init_value
is the incorrect table element type.
pub fn defined_table_grow(
&self,
table_index: DefinedTableIndex,
delta: u32,
init_value: TableElement
) -> Option<u32>
[src]
&self,
table_index: DefinedTableIndex,
delta: u32,
init_value: TableElement
) -> Option<u32>
Grow table in this instance by the specified amount of elements.
When the table is successfully grown, returns the original size of the table.
Returns None
if memory can’t be grown by the specified amount of pages
or if the init_value
is the incorrect table element type.
pub fn table_get(
&self,
table_index: DefinedTableIndex,
index: u32
) -> Option<TableElement>
[src]
&self,
table_index: DefinedTableIndex,
index: u32
) -> Option<TableElement>
Get table element reference.
Returns None
if index is out of bounds.
pub fn table_set(
&self,
table_index: DefinedTableIndex,
index: u32,
val: TableElement
) -> Result<(), ()>
[src]
&self,
table_index: DefinedTableIndex,
index: u32,
val: TableElement
) -> Result<(), ()>
Set table element reference.
Returns an error if the index is out of bounds
pub fn defined_table_fill(
&self,
table_index: DefinedTableIndex,
dst: u32,
val: TableElement,
len: u32
) -> Result<(), Trap>
[src]
&self,
table_index: DefinedTableIndex,
dst: u32,
val: TableElement,
len: u32
) -> Result<(), Trap>
Fill a region of the table.
Returns an error if the region is out of bounds or val is not of the correct type.
pub fn get_defined_table(&self, index: DefinedTableIndex) -> &Table
[src]
Get a table defined locally within this module.
pub unsafe fn clone(&self) -> InstanceHandle
[src]
Returns a clone of this instance.
This is unsafe because the returned handle here is just a cheap clone of the internals, there’s no lifetime tracking around its validity. You’ll need to ensure that the returned handles all go out of scope at the same time.
pub unsafe fn dealloc(&self)
[src]
Deallocates memory associated with this instance.
Note that this is unsafe because there might be other handles to this
InstanceHandle
elsewhere, and there’s nothing preventing usage of
this handle after this function is called.
Trait Implementations
impl Eq for InstanceHandle
[src]
impl Hash for InstanceHandle
[src]
fn hash<__H: Hasher>(&self, state: &mut __H)
[src]
pub fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,
1.3.0[src]
H: Hasher,
impl PartialEq<InstanceHandle> for InstanceHandle
[src]
fn eq(&self, other: &InstanceHandle) -> bool
[src]
fn ne(&self, other: &InstanceHandle) -> bool
[src]
impl StructuralEq for InstanceHandle
[src]
impl StructuralPartialEq for InstanceHandle
[src]
Auto Trait Implementations
impl !RefUnwindSafe for InstanceHandle
impl !Send for InstanceHandle
impl !Sync for InstanceHandle
impl Unpin for InstanceHandle
impl !UnwindSafe for InstanceHandle
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> CallHasher for T where
T: Hash,
[src]
T: Hash,
impl<Q, K> Equivalent<K> for Q where
K: Borrow<Q> + ?Sized,
Q: Eq + ?Sized,
[src]
K: Borrow<Q> + ?Sized,
Q: Eq + ?Sized,
pub fn equivalent(&self, key: &K) -> bool
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,