Struct InstancePre

pub struct InstancePre<T> { /* private fields */ }

Available on crate feature runtime only.

An instance, pre-instantiation, that is ready to be instantiated.

This structure represents an instance just before it was instantiated, after all type-checking and imports have been resolved. The only thing left to do for this instance is to actually run the process of instantiation.

Note that an InstancePre may not be tied to any particular Store if none of the imports it closed over are tied to any particular Store.

This structure is created through the Linker::instantiate_pre method, which also has some more information and examples.

Implementations

impl<T> InstancePre<T>

pub fn module(&self) -> &Module

Returns a reference to the module that this InstancePre will be instantiating.

pub fn instantiate( &self, store: impl AsContextMut<Data = T>, ) -> Result<Instance>

Instantiates this instance, creating a new instance within the provided store.

This function will run the actual process of instantiation to completion. This will use all of the previously-closed-over items as imports to instantiate the module that this was originally created with.

For more information about instantiation see Instance::new.

Panics

Panics if any import closed over by this InstancePre isn’t owned by store, or if store has async support enabled. Additionally this function will panic if the store provided comes from a different Engine than the InstancePre originally came from.

pub async fn instantiate_async( &self, store: impl AsContextMut<Data = T>, ) -> Result<Instance>

where T: Send,

Available on crate feature async only.

Creates a new instance, running the start function asynchronously instead of inline.

For more information about asynchronous instantiation see the documentation on Instance::new_async.

Panics

Panics if any import closed over by this InstancePre isn’t owned by store, or if store does not have async support enabled.

Trait Implementations

impl<T> Clone for InstancePre<T>

InstancePre’s clone does not require T: Clone

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.