NAME

Wasm::Wasmtime::Instance - Wasmtime instance class

VERSION

version 0.23

SYNOPSIS

use Wasm::Wasmtime;

my $store = Wasm::Wasmtime::Store->new;
my $module = Wasm::Wasmtime::Module->new($store->engine, wat => '(module)');
my $instance = Wasm::Wasmtime::Instance->new($module, $store, []);

DESCRIPTION

WARNING: WebAssembly and Wasmtime are a moving target and the interface for these modules is under active development. Use with caution.

This class represents an instance of a WebAssembly module Wasm::Wasmtime::Module.

CONSTRUCTOR

new

my $instance = Wasm::Wasmtime::Instance->new(
  $module,    # Wasm::Wasmtime::Module
  $store      # Wasm::Wasmtime::Store
);
my $instance = Wasm::Wasmtime::Instance->new(
  $module,    # Wasm::Wasmtime::Module
  $store,     # Wasm::Wasmtime::Store
  \@imports,  # array reference of Wasm::Wasmtime::Extern
);

Create a new instance of the instance class. @imports should match the imports specified by $module. You can use a few shortcuts when specifying imports:

code reference

For a function import, you can provide a plan Perl subroutine, since we can determine the function signature from the $module.

scalar reference

For a memory import, a memory object will be created and the referred scalar will be set to it.

undef

For a memory import, a memory object will be created. You won't be able to access it from Perl space, but at least it won't die.

METHODS

module

my $module = $instance->module;

Returns the Wasm::Wasmtime::Module for this instance.

exports

my $exports = $instance->exports;

Returns the Wasm:Wasmtime::Instance::Exports object for this instance. This can be used to query and call exports from the instance.

SEE ALSO

Wasm

Wasm::Wasmtime

AUTHOR

Graham Ollis <plicease@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2020-2022 by Graham Ollis.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.