/* Example of using `externref` values. You can compile and run this example on Linux with: cargo build --release -p wasmtime-c-api cc examples/externref.c \ -I crates/c-api/include \ -I crates/c-api/wasm-c-api/include \ target/release/libwasmtime.a \ -lpthread -ldl -lm \ -o externref ./externref Note that on Windows and macOS the command will be similar, but you'll need to tweak the `-lpthread` and such annotations as well as the name of the `libwasmtime.a` file on Windows. You can also build using cmake: mkdir build && cd build && cmake .. && \ cmake --build . --target wasmtime-externref */ #include #include #include #include #include #include static void exit_with_error(const char *message, wasmtime_error_t *error, wasm_trap_t *trap); int main() { int ret = 0; bool ok = true; // Create a new configuration with Wasm reference types enabled. printf("Initializing...\n"); wasm_config_t *config = wasm_config_new(); assert(config != NULL); wasmtime_config_wasm_reference_types_set(config, true); // Create an *engine*, which is a compilation context, with our configured // options. wasm_engine_t *engine = wasm_engine_new_with_config(config); assert(engine != NULL); // With an engine we can create a *store* which is a long-lived group of wasm // modules. wasmtime_store_t *store = wasmtime_store_new(engine, NULL, NULL); assert(store != NULL); wasmtime_context_t *context = wasmtime_store_context(store); // Read our input file, which in this case is a wasm text file. FILE *file = fopen("examples/externref.wat", "r"); assert(file != NULL); 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); assert(fread(wat.data, file_size, 1, file) == 1); fclose(file); // Parse the wat into the binary wasm format wasm_byte_vec_t wasm; wasmtime_error_t *error = wasmtime_wat2wasm(wat.data, wat.size, &wasm); if (error != NULL) exit_with_error("failed to parse wat", error, NULL); wasm_byte_vec_delete(&wat); // Now that we've got our binary webassembly we can compile our module. printf("Compiling module...\n"); wasmtime_module_t *module = NULL; error = wasmtime_module_new(engine, (uint8_t *)wasm.data, wasm.size, &module); wasm_byte_vec_delete(&wasm); if (error != NULL) exit_with_error("failed to compile module", error, NULL); // Instantiate the module. printf("Instantiating module...\n"); wasm_trap_t *trap = NULL; wasmtime_instance_t instance; error = wasmtime_instance_new(context, module, NULL, 0, &instance, &trap); if (error != NULL || trap != NULL) exit_with_error("failed to instantiate", error, trap); printf("Creating new `externref`...\n"); // Create a new `externref` value. // // Note that the NULL here is a finalizer callback, but we don't need one for // this example. wasmtime_externref_t *externref = wasmtime_externref_new("Hello, World!", NULL); // The `externref`'s wrapped data should be the string "Hello, World!". void *data = wasmtime_externref_data(externref); assert(strcmp((char *)data, "Hello, World!") == 0); printf("Touching `externref` table...\n"); wasmtime_extern_t item; // Lookup the `table` export. ok = wasmtime_instance_export_get(context, &instance, "table", strlen("table"), &item); assert(ok); assert(item.kind == WASMTIME_EXTERN_TABLE); // Set `table[3]` to our `externref`. wasmtime_val_t externref_val; externref_val.kind = WASMTIME_EXTERNREF; externref_val.of.externref = externref; error = wasmtime_table_set(context, &item.of.table, 3, &externref_val); if (error != NULL) exit_with_error("failed to set table", error, NULL); // `table[3]` should now be our `externref`. wasmtime_val_t elem; ok = wasmtime_table_get(context, &item.of.table, 3, &elem); assert(ok); assert(elem.kind == WASMTIME_EXTERNREF); assert(strcmp((char *)wasmtime_externref_data(elem.of.externref), "Hello, World!") == 0); wasmtime_val_delete(&elem); printf("Touching `externref` global...\n"); // Lookup the `global` export. ok = wasmtime_instance_export_get(context, &instance, "global", strlen("global"), &item); assert(ok); assert(item.kind == WASMTIME_EXTERN_GLOBAL); // Set the global to our `externref`. error = wasmtime_global_set(context, &item.of.global, &externref_val); if (error != NULL) exit_with_error("failed to set global", error, NULL); // Get the global, and it should return our `externref` again. wasmtime_val_t global_val; wasmtime_global_get(context, &item.of.global, &global_val); assert(global_val.kind == WASMTIME_EXTERNREF); assert(strcmp((char *)wasmtime_externref_data(elem.of.externref), "Hello, World!") == 0); wasmtime_val_delete(&global_val); printf("Calling `externref` func...\n"); // Lookup the `func` export. ok = wasmtime_instance_export_get(context, &instance, "func", strlen("func"), &item); assert(ok); assert(item.kind == WASMTIME_EXTERN_FUNC); // And call it! wasmtime_val_t results[1]; error = wasmtime_func_call(context, &item.of.func, &externref_val, 1, results, 1, &trap); if (error != NULL || trap != NULL) exit_with_error("failed to call function", error, trap); // `func` returns the same reference we gave it, so `results[0]` should be our // `externref`. assert(results[0].kind == WASMTIME_EXTERNREF); assert(strcmp((char *)wasmtime_externref_data(results[0].of.externref), "Hello, World!") == 0); wasmtime_val_delete(&results[0]); // We can GC any now-unused references to our externref that the store is // holding. printf("GCing within the store...\n"); wasmtime_context_gc(context); // Clean up after ourselves at this point printf("All finished!\n"); ret = 0; wasmtime_store_delete(store); wasmtime_module_delete(module); wasm_engine_delete(engine); return 0; } static void exit_with_error(const char *message, wasmtime_error_t *error, wasm_trap_t *trap) { fprintf(stderr, "error: %s\n", message); wasm_byte_vec_t error_message; if (error != NULL) { wasmtime_error_message(error, &error_message); wasmtime_error_delete(error); } else { wasm_trap_message(trap, &error_message); wasm_trap_delete(trap); } fprintf(stderr, "%.*s\n", (int)error_message.size, error_message.data); wasm_byte_vec_delete(&error_message); exit(1); }