#include <wasmtime/component/types/func.h>
#include <wasmtime/component/val.h>
#include <wasmtime/conf.h>
#include <wasmtime/error.h>
#include <wasmtime/store.h>

Data Structures
struct	wasmtime_component_func
	Representation of a function in Wasmtime. More...

Typedefs
typedef struct wasmtime_component_func	wasmtime_component_func_t
	Representation of a function in Wasmtime. More...

Functions
WASM_API_EXTERN wasmtime_component_func_type_t *	wasmtime_component_func_type (const wasmtime_component_func_t func, wasmtime_context_t context)
	Returns the type of this function. More...

WASM_API_EXTERN wasmtime_error_t *	wasmtime_component_func_call (const wasmtime_component_func_t func, wasmtime_context_t context, const wasmtime_component_val_t args, size_t args_size, wasmtime_component_val_t results, size_t results_size)
	Invokes `func` with the `args` given and returns the result. More...

WASM_API_EXTERN wasmtime_error_t *	wasmtime_component_func_post_return (const wasmtime_component_func_t func, wasmtime_context_t context)
	No longer needs to be called; this function has no effect. More...

Typedef Documentation

◆ wasmtime_component_func_t

typedef struct wasmtime_component_func wasmtime_component_func_t

Representation of a function in Wasmtime.

Functions in Wasmtime are represented as an index into a store and don't have any data or destructor associated with the value. Functions cannot interoperate between wasmtime_store_t instances and if the wrong function is passed to the wrong store then it may trigger an assertion to abort the process.

Function Documentation

◆ wasmtime_component_func_call()

WASM_API_EXTERN wasmtime_error_t * wasmtime_component_func_call	(	const wasmtime_component_func_t *	func,
		wasmtime_context_t *	context,
		const wasmtime_component_val_t *	args,
		size_t	args_size,
		wasmtime_component_val_t *	results,
		size_t	results_size
	)

Invokes func with the args given and returns the result.

The args provided must match the parameters that this function takes in terms of their types and the number of parameters. Results will be written to the results provided if the call completes successfully. The initial types of the values in results are ignored and values are overwritten to write the result. It's required that the results_size exactly matches the number of results that this function produces.

◆ wasmtime_component_func_post_return()

WASM_API_EXTERN wasmtime_error_t * wasmtime_component_func_post_return	(	const wasmtime_component_func_t *	func,
		wasmtime_context_t *	context
	)

No longer needs to be called; this function has no effect.

Deprecated:: Previously, this invoked the post-return canonical ABI option, if specified, after a wasmtime_component_func_call had finished. Now that's taken care of automatically as part of wasmtime_component_func_call, so this function is no longer needed, and any calls to it may be removed.

◆ wasmtime_component_func_type()

WASM_API_EXTERN wasmtime_component_func_type_t * wasmtime_component_func_type	(	const wasmtime_component_func_t *	func,
		wasmtime_context_t *	context
	)

Returns the type of this function.

The caller must deallocate the returned pointer with wasmtime_component_func_type_delete.

Data Structures