[−][src]Struct wasmtime_jit::InstanceHandle
A handle holding an Instance
of a WebAssembly module.
Methods
impl InstanceHandle
[src]
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 + 'static>
) -> Result<InstanceHandle, InstantiationError>
[src]
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 + 'static>
) -> Result<InstanceHandle, 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) -> InstanceHandle
[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) -> &Arc<Module>
[src]
Return a reference-counting pointer to a module.
pub fn module_ref(&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: &Export) -> Export
[src]
Lookup an export with the given export declaration.
pub fn exports(&self) -> Iter<String, Export>
[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 + 'static)
[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: DefinedTableIndex,
delta: u32
) -> Option<u32>
[src]
&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>
[src]
&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<(), ()>
[src]
&self,
table_index: DefinedTableIndex,
index: u32,
val: VMCallerCheckedAnyfunc
) -> Result<(), ()>
Set table element reference.
Returns an error if the index is out of bounds
impl InstanceHandle
[src]
pub fn set_signal_handler<H>(&mut self, handler: H) where
H: 'static + Fn(i32, *const siginfo_t, *const c_void) -> bool,
[src]
H: 'static + Fn(i32, *const siginfo_t, *const c_void) -> bool,
Set a custom signal handler
Trait Implementations
impl Clone for InstanceHandle
[src]
fn clone(&self) -> InstanceHandle
[src]
fn clone_from(&mut self, source: &Self)
1.0.0[src]
impl Drop for InstanceHandle
[src]
impl Eq for InstanceHandle
[src]
impl Hash for InstanceHandle
[src]
fn hash<__H>(&self, state: &mut __H) where
__H: Hasher,
[src]
__H: Hasher,
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,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<Q, K> Equivalent<K> for Q where
K: Borrow<Q> + ?Sized,
Q: Eq + ?Sized,
[src]
K: Borrow<Q> + ?Sized,
Q: Eq + ?Sized,
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> Same<T> for T
type Output = T
Should always be Self
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
fn to_owned(&self) -> T
[src]
fn clone_into(&self, target: &mut T)
[src]
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.
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>,