Struct Engine 

pub struct Engine(/* private fields */);

Newtype wrapper around wasmer::Engine.

Implementations

impl Engine

pub fn new(inner: Engine) -> Self

Create a wasm_runtime_layer::Engine-compatible Engine from a wasmer::Engine.

pub fn into_inner(self) -> Engine

Consume a Engine to obtain the inner wasmer::Engine.

Methods from Deref<Target = Engine>

pub fn as_sys(&self) -> &Engine

Convert a reference to self into a reference crate::backend::sys::engine::Engine.

pub fn as_sys_mut(&mut self) -> &mut Engine

Convert a mutable reference to self into a mutable reference crate::backend::sys::engine::Engine.

pub fn is_sys(&self) -> bool

Return true if self is an engine from the sys runtime.

pub fn deterministic_id(&self) -> String

Returns the deterministic id of this engine.

pub fn id(&self) -> EngineId

Returns the unique id of this engine.

pub fn with_opts( &mut self, suggested_opts: &UserCompilerOptimizations, ) -> Result<(), CompileError>

Add suggested optimizations to this engine.

Note

Not every backend supports every optimization. This function may fail (i.e. not set the suggested optimizations) silently if the underlying engine backend does not support one or more optimizations.

Trait Implementations

impl<T: 'static> AsContext<Engine> for Store<T>

type UserState = T

The type of data associated with the store.

fn as_context(&self) -> StoreContext<'_, Self::UserState>

Returns the store context that this type provides access to.

impl<T: 'static> AsContext<Engine> for StoreContext<'_, T>

type UserState = T

The type of data associated with the store.

fn as_context(&self) -> StoreContext<'_, T>

Returns the store context that this type provides access to.

impl<T: 'static> AsContext<Engine> for StoreContextMut<'_, T>

type UserState = T

The type of data associated with the store.

fn as_context(&self) -> StoreContext<'_, T>

Returns the store context that this type provides access to.

impl<T: 'static> AsContextMut<Engine> for Store<T>

fn as_context_mut(&mut self) -> StoreContextMut<'_, Self::UserState>

Returns the store context that this type provides access to.

impl<T: 'static> AsContextMut<Engine> for StoreContextMut<'_, T>

fn as_context_mut(&mut self) -> StoreContextMut<'_, T>

Returns the store context that this type provides access to.

impl AsMut<Engine> for Engine

fn as_mut(&mut self) -> &mut Engine

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsMut<Engine> for Engine

fn as_mut(&mut self) -> &mut Engine

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<Engine> for Engine

fn as_ref(&self) -> &Engine

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<Engine> for Engine

fn as_ref(&self) -> &Engine

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Engine

fn clone(&self) -> Engine

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Engine

fn default() -> Engine

Returns the “default value” for a type.

impl Deref for Engine

type Target = Engine

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for Engine

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl From<Engine> for Engine

fn from(inner: Engine) -> Self

Converts to this type from the input type.

impl From<Engine> for Engine

fn from(wrapper: Engine) -> Self

Converts to this type from the input type.

impl RefCast for Engine

type From = Engine

fn ref_cast(_from: &Self::From) -> &Self

fn ref_cast_mut(_from: &mut Self::From) -> &mut Self

impl WasmEngine for Engine

type ExternRef = ExternRef

The external reference type.

type Func = Func

The function type.

type Global = Global

The global type.

type Instance = Instance

The instance type.

type Memory = Memory

The memory type.

type Module = Module

The module type.

type Store<T: 'static> = Store<T>

The store type.

type StoreContext<'a, T: 'static> = StoreContext<'a, T>

The store context type.

type StoreContextMut<'a, T: 'static> = StoreContextMut<'a, T>

The mutable store context type.

type Table = Table

The table type.

impl WasmExternRef<Engine> for ExternRef

fn new<T: 'static + Send + Sync>( ctx: impl AsContextMut<Engine>, object: T, ) -> Self

Creates a new reference wrapping the given value.

fn downcast<'a, 's: 'a, T: 'static, S: 's>( &'a self, ctx: StoreContext<'s, S>, ) -> Result<&'a T>

Returns a shared reference to the underlying data.

impl WasmFunc<Engine> for Func

fn new<T: 'static>( ctx: impl AsContextMut<Engine, UserState = T>, ty: FuncType, func: impl 'static + Send + Sync + Fn(StoreContextMut<'_, T>, &[Value<Engine>], &mut [Value<Engine>]) -> Result<()>, ) -> Self

Creates a new function with the given arguments.

fn ty(&self, ctx: impl AsContext<Engine>) -> FuncType

Gets the function type of this object.

fn call<T>( &self, ctx: impl AsContextMut<Engine>, args: &[Value<Engine>], results: &mut [Value<Engine>], ) -> Result<()>

Calls the object with the given arguments.

impl WasmGlobal<Engine> for Global

fn new( ctx: impl AsContextMut<Engine>, value: Value<Engine>, mutable: bool, ) -> Self

Creates a new global variable to the store.

fn ty(&self, ctx: impl AsContext<Engine>) -> GlobalType

Returns the type of the global variable.

fn set( &self, ctx: impl AsContextMut<Engine>, new_value: Value<Engine>, ) -> Result<()>

Sets the value of the global variable.

fn get(&self, ctx: impl AsContextMut<Engine>) -> Value<Engine>

Gets the value of the global variable.

impl WasmInstance<Engine> for Instance

fn new( store: impl AsContextMut<Engine>, module: &Module, imports: &Imports<Engine>, ) -> Result<Self>

Creates a new instance.

fn exports( &self, _: impl AsContext<Engine>, ) -> Box<dyn Iterator<Item = Export<Engine>>>

Gets the exports of this instance.

fn get_export( &self, _: impl AsContext<Engine>, name: &str, ) -> Option<Extern<Engine>>

Gets the export of the given name, if any, from this instance.

impl WasmMemory<Engine> for Memory

fn new(ctx: impl AsContextMut<Engine>, ty: MemoryType) -> Result<Self>

Creates a new linear memory to the store.

fn ty(&self, ctx: impl AsContext<Engine>) -> MemoryType

Returns the memory type of the linear memory.

fn grow(&self, ctx: impl AsContextMut<Engine>, additional: u32) -> Result<u32>

Grows the linear memory by the given amount of new pages.

fn current_pages(&self, ctx: impl AsContext<Engine>) -> u32

Returns the amount of pages in use by the linear memory.

fn read( &self, ctx: impl AsContext<Engine>, offset: usize, buffer: &mut [u8], ) -> Result<()>

Reads n bytes from memory[offset..offset+n] into buffer where n is the length of buffer.

fn write( &self, ctx: impl AsContextMut<Engine>, offset: usize, buffer: &[u8], ) -> Result<()>

Writes n bytes to memory[offset..offset+n] from buffer where n if the length of buffer.

impl WasmModule<Engine> for Module

fn new(engine: &Engine, bytes: &[u8]) -> Result<Self>

Creates a new module from the given byte slice.

fn exports(&self) -> Box<dyn Iterator<Item = ExportType<'_>> + '_>

Gets the export types of the module.

fn get_export(&self, name: &str) -> Option<ExternType>

Gets the export type of the given name, if any, from this module.

fn imports(&self) -> Box<dyn Iterator<Item = ImportType<'_>> + '_>

Gets the import types of the module.

impl<T: 'static> WasmStore<T, Engine> for Store<T>

fn new(engine: &Engine, data: T) -> Self

Creates a new store atop the given engine.

fn engine(&self) -> &Engine

Gets the engine associated with this store.

fn data(&self) -> &T

Gets an immutable reference to the underlying stored data.

fn data_mut(&mut self) -> &mut T

Gets a mutable reference to the underlying stored data.

fn into_data(self) -> T

Consumes self and returns its user provided data.

impl<'a, T: 'static> WasmStoreContext<'a, T, Engine> for StoreContext<'a, T>

fn engine(&self) -> &Engine

Gets the engine associated with this store.

fn data(&self) -> &T

Gets an immutable reference to the underlying stored data.

impl<'a, T: 'static> WasmStoreContext<'a, T, Engine> for StoreContextMut<'a, T>

fn engine(&self) -> &Engine

Gets the engine associated with this store.

fn data(&self) -> &T

Gets an immutable reference to the underlying stored data.

impl<'a, T: 'static> WasmStoreContextMut<'a, T, Engine> for StoreContextMut<'a, T>

fn data_mut(&mut self) -> &mut T

Gets a mutable reference to the underlying stored data.

impl WasmTable<Engine> for Table

fn new( ctx: impl AsContextMut<Engine>, ty: TableType, init: Value<Engine>, ) -> Result<Self>

Creates a new table to the store.

fn ty(&self, ctx: impl AsContext<Engine>) -> TableType

Returns the type and limits of the table.

fn size(&self, ctx: impl AsContext<Engine>) -> u32

Returns the current size of the table.

fn grow( &self, ctx: impl AsContextMut<Engine>, delta: u32, init: Value<Engine>, ) -> Result<u32>

Grows the table by the given amount of elements.

fn get( &self, ctx: impl AsContextMut<Engine>, index: u32, ) -> Option<Value<Engine>>

Returns the table element value at index.

fn set( &self, ctx: impl AsContextMut<Engine>, index: u32, value: Value<Engine>, ) -> Result<()>

Sets the value of this table at index.