* Move all examples to a top-level directory This commit moves all API examples (Rust and C) to a top-level `examples` directory. This is intended to make it more discoverable and conventional as to where examples are located. Additionally all examples are now available in both Rust and C to see how to execute the example in the language you're familiar with. The intention is that as more languages are supported we'd add more languages as examples here too. Each example is also accompanied by either a `*.wat` file which is parsed as input, or a Rust project in a `wasm` folder which is compiled as input. A simple driver crate was also added to `crates/misc` which executes all the examples on CI, ensuring the C and Rust examples all execute successfully.
180 lines
4.5 KiB
C
180 lines
4.5 KiB
C
/*
|
|
Example of instantiating of the WebAssembly module and invoking its exported
|
|
function.
|
|
|
|
You can compile and run this example on Linux with:
|
|
|
|
cargo build --release -p wasmtime
|
|
cc examples/multi.c \
|
|
-I crates/c-api/include \
|
|
-I crates/c-api/wasm-c-api/include \
|
|
target/release/libwasmtime.a \
|
|
-lpthread -ldl -lm \
|
|
-o multi
|
|
./multi
|
|
|
|
Note that on Windows and macOS the command will be similar, but you'll need
|
|
to tweak the `-lpthread` and such annotations.
|
|
|
|
Also note that this example was taken from
|
|
https://github.com/WebAssembly/wasm-c-api/blob/master/example/multi.c
|
|
originally
|
|
*/
|
|
|
|
#include <stdio.h>
|
|
#include <stdlib.h>
|
|
#include <string.h>
|
|
#include <inttypes.h>
|
|
#include <wasm.h>
|
|
#include <wasmtime.h>
|
|
|
|
// A function to be called from Wasm code.
|
|
wasm_trap_t* callback(
|
|
const wasm_val_t args[], wasm_val_t results[]
|
|
) {
|
|
printf("Calling back...\n");
|
|
printf("> %"PRIu32" %"PRIu64"\n", args[0].of.i32, args[1].of.i64);
|
|
printf("\n");
|
|
|
|
wasm_val_copy(&results[0], &args[1]);
|
|
wasm_val_copy(&results[1], &args[0]);
|
|
return NULL;
|
|
}
|
|
|
|
|
|
// A function closure.
|
|
wasm_trap_t* closure_callback(
|
|
void* env, const wasm_val_t args[], wasm_val_t results[]
|
|
) {
|
|
int i = *(int*)env;
|
|
printf("Calling back closure...\n");
|
|
printf("> %d\n", i);
|
|
|
|
results[0].kind = WASM_I32;
|
|
results[0].of.i32 = (int32_t)i;
|
|
return NULL;
|
|
}
|
|
|
|
|
|
int main(int argc, const char* argv[]) {
|
|
// Initialize.
|
|
printf("Initializing...\n");
|
|
wasm_config_t *config = wasm_config_new();
|
|
assert(config != NULL);
|
|
wasmtime_config_wasm_multi_value_set(config, true);
|
|
wasm_engine_t* engine = wasm_engine_new_with_config(config);
|
|
wasm_store_t* store = wasm_store_new(engine);
|
|
|
|
// Load our input file to parse it next
|
|
FILE* file = fopen("examples/multi.wat", "r");
|
|
if (!file) {
|
|
printf("> Error loading file!\n");
|
|
return 1;
|
|
}
|
|
fseek(file, 0L, SEEK_END);
|
|
size_t file_size = ftell(file);
|
|
fseek(file, 0L, SEEK_SET);
|
|
wasm_byte_vec_t wat;
|
|
wasm_byte_vec_new_uninitialized(&wat, file_size);
|
|
if (fread(wat.data, file_size, 1, file) != 1) {
|
|
printf("> Error loading module!\n");
|
|
return 1;
|
|
}
|
|
fclose(file);
|
|
|
|
// Parse the wat into the binary wasm format
|
|
wasm_byte_vec_t binary, error;
|
|
if (wasmtime_wat2wasm(engine, &wat, &binary, &error) == 0) {
|
|
fprintf(stderr, "failed to parse wat %.*s\n", (int) error.size, error.data);
|
|
return 1;
|
|
}
|
|
wasm_byte_vec_delete(&wat);
|
|
|
|
// Compile.
|
|
printf("Compiling module...\n");
|
|
wasm_module_t* module = wasm_module_new(store, &binary);
|
|
if (!module) {
|
|
printf("> Error compiling module!\n");
|
|
return 1;
|
|
}
|
|
|
|
wasm_byte_vec_delete(&binary);
|
|
|
|
// Create external print functions.
|
|
printf("Creating callback...\n");
|
|
wasm_functype_t* callback_type = wasm_functype_new_2_2(
|
|
wasm_valtype_new_i32(),
|
|
wasm_valtype_new_i64(),
|
|
wasm_valtype_new_i64(),
|
|
wasm_valtype_new_i32()
|
|
);
|
|
wasm_func_t* callback_func =
|
|
wasm_func_new(store, callback_type, callback);
|
|
|
|
wasm_functype_delete(callback_type);
|
|
|
|
// Instantiate.
|
|
printf("Instantiating module...\n");
|
|
const wasm_extern_t* imports[] = {wasm_func_as_extern(callback_func)};
|
|
wasm_instance_t* instance =
|
|
wasm_instance_new(store, module, imports, NULL);
|
|
if (!instance) {
|
|
printf("> Error instantiating module!\n");
|
|
return 1;
|
|
}
|
|
|
|
wasm_func_delete(callback_func);
|
|
|
|
// Extract export.
|
|
printf("Extracting export...\n");
|
|
wasm_extern_vec_t exports;
|
|
wasm_instance_exports(instance, &exports);
|
|
if (exports.size == 0) {
|
|
printf("> Error accessing exports!\n");
|
|
return 1;
|
|
}
|
|
const wasm_func_t* run_func = wasm_extern_as_func(exports.data[0]);
|
|
if (run_func == NULL) {
|
|
printf("> Error accessing export!\n");
|
|
return 1;
|
|
}
|
|
|
|
wasm_module_delete(module);
|
|
wasm_instance_delete(instance);
|
|
|
|
// Call.
|
|
printf("Calling export...\n");
|
|
wasm_val_t args[4];
|
|
args[0].kind = WASM_I32;
|
|
args[0].of.i32 = 1;
|
|
args[1].kind = WASM_I64;
|
|
args[1].of.i64 = 2;
|
|
wasm_val_t results[2];
|
|
if (wasm_func_call(run_func, args, results)) {
|
|
printf("> Error calling function!\n");
|
|
return 1;
|
|
}
|
|
|
|
wasm_extern_vec_delete(&exports);
|
|
|
|
// Print result.
|
|
printf("Printing result...\n");
|
|
printf("> %"PRIu64" %"PRIu32"\n",
|
|
results[0].of.i64, results[1].of.i32);
|
|
|
|
assert(results[0].kind == WASM_I64);
|
|
assert(results[0].of.i64 == 2);
|
|
assert(results[1].kind == WASM_I32);
|
|
assert(results[1].of.i32 == 1);
|
|
|
|
// Shut down.
|
|
printf("Shutting down...\n");
|
|
wasm_store_delete(store);
|
|
wasm_engine_delete(engine);
|
|
|
|
// All done.
|
|
printf("Done.\n");
|
|
return 0;
|
|
}
|
|
|