wasm_c_api.h 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685
  1. // WebAssembly C API
  2. #ifndef WASM_H
  3. #define WASM_H
  4. #include <stddef.h>
  5. #include <stdint.h>
  6. #include <stdbool.h>
  7. #include <string.h>
  8. #include <assert.h>
  9. #ifndef WASM_API_EXTERN
  10. #ifdef _WIN32
  11. #define WASM_API_EXTERN __declspec(dllimport)
  12. #else
  13. #define WASM_API_EXTERN
  14. #endif
  15. #endif
  16. #ifdef __cplusplus
  17. extern "C" {
  18. #endif
  19. ///////////////////////////////////////////////////////////////////////////////
  20. // Auxiliaries
  21. // Machine types
  22. #if (__STDC_VERSION__ > 199901L)
  23. inline void assertions() {
  24. static_assert(sizeof(float) == sizeof(uint32_t), "incompatible float type");
  25. static_assert(sizeof(double) == sizeof(uint64_t), "incompatible double type");
  26. static_assert(sizeof(intptr_t) == sizeof(uint32_t) ||
  27. sizeof(intptr_t) == sizeof(uint64_t),
  28. "incompatible pointer type");
  29. }
  30. #endif /* __STDC_VERSION__ > 199901L */
  31. typedef char byte_t;
  32. typedef float float32_t;
  33. typedef double float64_t;
  34. // Ownership
  35. #define own
  36. // The qualifier `own` is used to indicate ownership of data in this API.
  37. // It is intended to be interpreted similar to a `const` qualifier:
  38. //
  39. // - `own wasm_xxx_t*` owns the pointed-to data
  40. // - `own wasm_xxx_t` distributes to all fields of a struct or union `xxx`
  41. // - `own wasm_xxx_vec_t` owns the vector as well as its elements(!)
  42. // - an `own` function parameter passes ownership from caller to callee
  43. // - an `own` function result passes ownership from callee to caller
  44. // - an exception are `own` pointer parameters named `out`, which are copy-back
  45. // output parameters passing back ownership from callee to caller
  46. //
  47. // Own data is created by `wasm_xxx_new` functions and some others.
  48. // It must be released with the corresponding `wasm_xxx_delete` function.
  49. //
  50. // Deleting a reference does not necessarily delete the underlying object,
  51. // it merely indicates that this owner no longer uses it.
  52. //
  53. // For vectors, `const wasm_xxx_vec_t` is used informally to indicate that
  54. // neither the vector nor its elements should be modified.
  55. // TODO: introduce proper `wasm_xxx_const_vec_t`?
  56. #define WASM_DECLARE_OWN(name) \
  57. typedef struct wasm_##name##_t wasm_##name##_t; \
  58. \
  59. WASM_API_EXTERN void wasm_##name##_delete(own wasm_##name##_t*);
  60. // Vectors
  61. // size: capacity
  62. // num_elems: current number of elements
  63. // size_of_elem: size of one element
  64. #define WASM_DECLARE_VEC(name, ptr_or_none) \
  65. typedef struct wasm_##name##_vec_t { \
  66. size_t size; \
  67. wasm_##name##_t ptr_or_none* data; \
  68. size_t num_elems; \
  69. size_t size_of_elem; \
  70. } wasm_##name##_vec_t; \
  71. \
  72. WASM_API_EXTERN void wasm_##name##_vec_new_empty(own wasm_##name##_vec_t* out); \
  73. WASM_API_EXTERN void wasm_##name##_vec_new_uninitialized( \
  74. own wasm_##name##_vec_t* out, size_t); \
  75. WASM_API_EXTERN void wasm_##name##_vec_new( \
  76. own wasm_##name##_vec_t* out, \
  77. size_t, own wasm_##name##_t ptr_or_none const[]); \
  78. WASM_API_EXTERN void wasm_##name##_vec_copy( \
  79. own wasm_##name##_vec_t* out, const wasm_##name##_vec_t*); \
  80. WASM_API_EXTERN void wasm_##name##_vec_delete(own wasm_##name##_vec_t*);
  81. // Byte vectors
  82. typedef byte_t wasm_byte_t;
  83. WASM_DECLARE_VEC(byte, )
  84. typedef wasm_byte_vec_t wasm_name_t;
  85. #define wasm_name wasm_byte_vec
  86. #define wasm_name_new wasm_byte_vec_new
  87. #define wasm_name_new_empty wasm_byte_vec_new_empty
  88. #define wasm_name_new_new_uninitialized wasm_byte_vec_new_uninitialized
  89. #define wasm_name_copy wasm_byte_vec_copy
  90. #define wasm_name_delete wasm_byte_vec_delete
  91. static inline void wasm_name_new_from_string(
  92. own wasm_name_t* out, const char* s
  93. ) {
  94. wasm_name_new(out, strlen(s) + 1, s);
  95. }
  96. ///////////////////////////////////////////////////////////////////////////////
  97. // Runtime Environment
  98. // Engine
  99. WASM_DECLARE_OWN(engine)
  100. WASM_API_EXTERN own wasm_engine_t* wasm_engine_new();
  101. // Store
  102. WASM_DECLARE_OWN(store)
  103. WASM_API_EXTERN own wasm_store_t* wasm_store_new(wasm_engine_t*);
  104. ///////////////////////////////////////////////////////////////////////////////
  105. // Type Representations
  106. // Type attributes
  107. typedef uint8_t wasm_mutability_t;
  108. enum wasm_mutability_enum {
  109. WASM_CONST,
  110. WASM_VAR,
  111. };
  112. typedef struct wasm_limits_t {
  113. uint32_t min;
  114. uint32_t max;
  115. } wasm_limits_t;
  116. static const uint32_t wasm_limits_max_default = 0xffffffff;
  117. // Generic
  118. #define WASM_DECLARE_TYPE(name) \
  119. WASM_DECLARE_OWN(name) \
  120. WASM_DECLARE_VEC(name, *) \
  121. \
  122. WASM_API_EXTERN own wasm_##name##_t* wasm_##name##_copy(wasm_##name##_t*);
  123. // Value Types
  124. WASM_DECLARE_TYPE(valtype)
  125. #ifndef WASM_VALKIND_T_DEFINED
  126. #define WASM_VALKIND_T_DEFINED
  127. typedef uint8_t wasm_valkind_t;
  128. enum wasm_valkind_enum {
  129. WASM_I32,
  130. WASM_I64,
  131. WASM_F32,
  132. WASM_F64,
  133. WASM_ANYREF = 128,
  134. WASM_FUNCREF,
  135. };
  136. #endif
  137. WASM_API_EXTERN own wasm_valtype_t* wasm_valtype_new(wasm_valkind_t);
  138. WASM_API_EXTERN wasm_valkind_t wasm_valtype_kind(const wasm_valtype_t*);
  139. static inline bool wasm_valkind_is_num(wasm_valkind_t k) {
  140. return k < WASM_ANYREF;
  141. }
  142. static inline bool wasm_valkind_is_ref(wasm_valkind_t k) {
  143. return k >= WASM_ANYREF;
  144. }
  145. static inline bool wasm_valtype_is_num(const wasm_valtype_t* t) {
  146. return wasm_valkind_is_num(wasm_valtype_kind(t));
  147. }
  148. static inline bool wasm_valtype_is_ref(const wasm_valtype_t* t) {
  149. return wasm_valkind_is_ref(wasm_valtype_kind(t));
  150. }
  151. // Function Types
  152. WASM_DECLARE_TYPE(functype)
  153. WASM_API_EXTERN own wasm_functype_t* wasm_functype_new(
  154. own wasm_valtype_vec_t* params, own wasm_valtype_vec_t* results);
  155. WASM_API_EXTERN const wasm_valtype_vec_t* wasm_functype_params(const wasm_functype_t*);
  156. WASM_API_EXTERN const wasm_valtype_vec_t* wasm_functype_results(const wasm_functype_t*);
  157. // Global Types
  158. WASM_DECLARE_TYPE(globaltype)
  159. WASM_API_EXTERN own wasm_globaltype_t* wasm_globaltype_new(
  160. own wasm_valtype_t*, wasm_mutability_t);
  161. WASM_API_EXTERN const wasm_valtype_t* wasm_globaltype_content(const wasm_globaltype_t*);
  162. WASM_API_EXTERN wasm_mutability_t wasm_globaltype_mutability(const wasm_globaltype_t*);
  163. // Table Types
  164. WASM_DECLARE_TYPE(tabletype)
  165. WASM_API_EXTERN own wasm_tabletype_t* wasm_tabletype_new(
  166. own wasm_valtype_t*, const wasm_limits_t*);
  167. WASM_API_EXTERN const wasm_valtype_t* wasm_tabletype_element(const wasm_tabletype_t*);
  168. WASM_API_EXTERN const wasm_limits_t* wasm_tabletype_limits(const wasm_tabletype_t*);
  169. // Memory Types
  170. WASM_DECLARE_TYPE(memorytype)
  171. WASM_API_EXTERN own wasm_memorytype_t* wasm_memorytype_new(const wasm_limits_t*);
  172. WASM_API_EXTERN const wasm_limits_t* wasm_memorytype_limits(const wasm_memorytype_t*);
  173. // Extern Types
  174. WASM_DECLARE_TYPE(externtype)
  175. typedef uint8_t wasm_externkind_t;
  176. enum wasm_externkind_enum {
  177. WASM_EXTERN_FUNC,
  178. WASM_EXTERN_GLOBAL,
  179. WASM_EXTERN_TABLE,
  180. WASM_EXTERN_MEMORY,
  181. };
  182. WASM_API_EXTERN wasm_externkind_t wasm_externtype_kind(const wasm_externtype_t*);
  183. WASM_API_EXTERN wasm_externtype_t* wasm_functype_as_externtype(wasm_functype_t*);
  184. WASM_API_EXTERN wasm_externtype_t* wasm_globaltype_as_externtype(wasm_globaltype_t*);
  185. WASM_API_EXTERN wasm_externtype_t* wasm_tabletype_as_externtype(wasm_tabletype_t*);
  186. WASM_API_EXTERN wasm_externtype_t* wasm_memorytype_as_externtype(wasm_memorytype_t*);
  187. WASM_API_EXTERN wasm_functype_t* wasm_externtype_as_functype(wasm_externtype_t*);
  188. WASM_API_EXTERN wasm_globaltype_t* wasm_externtype_as_globaltype(wasm_externtype_t*);
  189. WASM_API_EXTERN wasm_tabletype_t* wasm_externtype_as_tabletype(wasm_externtype_t*);
  190. WASM_API_EXTERN wasm_memorytype_t* wasm_externtype_as_memorytype(wasm_externtype_t*);
  191. WASM_API_EXTERN const wasm_externtype_t* wasm_functype_as_externtype_const(const wasm_functype_t*);
  192. WASM_API_EXTERN const wasm_externtype_t* wasm_globaltype_as_externtype_const(const wasm_globaltype_t*);
  193. WASM_API_EXTERN const wasm_externtype_t* wasm_tabletype_as_externtype_const(const wasm_tabletype_t*);
  194. WASM_API_EXTERN const wasm_externtype_t* wasm_memorytype_as_externtype_const(const wasm_memorytype_t*);
  195. WASM_API_EXTERN const wasm_functype_t* wasm_externtype_as_functype_const(const wasm_externtype_t*);
  196. WASM_API_EXTERN const wasm_globaltype_t* wasm_externtype_as_globaltype_const(const wasm_externtype_t*);
  197. WASM_API_EXTERN const wasm_tabletype_t* wasm_externtype_as_tabletype_const(const wasm_externtype_t*);
  198. WASM_API_EXTERN const wasm_memorytype_t* wasm_externtype_as_memorytype_const(const wasm_externtype_t*);
  199. // Import Types
  200. WASM_DECLARE_TYPE(importtype)
  201. WASM_API_EXTERN own wasm_importtype_t* wasm_importtype_new(
  202. own wasm_name_t* module, own wasm_name_t* name, own wasm_externtype_t*);
  203. WASM_API_EXTERN const wasm_name_t* wasm_importtype_module(const wasm_importtype_t*);
  204. WASM_API_EXTERN const wasm_name_t* wasm_importtype_name(const wasm_importtype_t*);
  205. WASM_API_EXTERN const wasm_externtype_t* wasm_importtype_type(const wasm_importtype_t*);
  206. // Export Types
  207. WASM_DECLARE_TYPE(exporttype)
  208. WASM_API_EXTERN own wasm_exporttype_t* wasm_exporttype_new(
  209. own wasm_name_t*, own wasm_externtype_t*);
  210. WASM_API_EXTERN const wasm_name_t* wasm_exporttype_name(const wasm_exporttype_t*);
  211. WASM_API_EXTERN const wasm_externtype_t* wasm_exporttype_type(const wasm_exporttype_t*);
  212. ///////////////////////////////////////////////////////////////////////////////
  213. // Runtime Objects
  214. // Values
  215. #ifndef WASM_VAL_T_DEFINED
  216. #define WASM_VAL_T_DEFINED
  217. struct wasm_ref_t;
  218. typedef struct wasm_val_t {
  219. wasm_valkind_t kind;
  220. union {
  221. int32_t i32;
  222. int64_t i64;
  223. float32_t f32;
  224. float64_t f64;
  225. struct wasm_ref_t* ref;
  226. } of;
  227. } wasm_val_t;
  228. #endif
  229. WASM_API_EXTERN void wasm_val_delete(own wasm_val_t* v);
  230. WASM_API_EXTERN void wasm_val_copy(own wasm_val_t* out, const wasm_val_t*);
  231. WASM_DECLARE_VEC(val, )
  232. // References
  233. #define WASM_DECLARE_REF_BASE(name) \
  234. WASM_DECLARE_OWN(name) \
  235. \
  236. WASM_API_EXTERN own wasm_##name##_t* wasm_##name##_copy(const wasm_##name##_t*); \
  237. WASM_API_EXTERN bool wasm_##name##_same(const wasm_##name##_t*, const wasm_##name##_t*);
  238. #define WASM_DECLARE_REF(name) \
  239. WASM_DECLARE_REF_BASE(name) \
  240. \
  241. WASM_API_EXTERN wasm_ref_t* wasm_##name##_as_ref(wasm_##name##_t*); \
  242. WASM_API_EXTERN wasm_##name##_t* wasm_ref_as_##name(wasm_ref_t*); \
  243. WASM_API_EXTERN const wasm_ref_t* wasm_##name##_as_ref_const(const wasm_##name##_t*); \
  244. WASM_API_EXTERN const wasm_##name##_t* wasm_ref_as_##name##_const(const wasm_ref_t*);
  245. #define WASM_DECLARE_SHARABLE_REF(name) \
  246. WASM_DECLARE_REF(name) \
  247. WASM_DECLARE_OWN(shared_##name) \
  248. \
  249. WASM_API_EXTERN own wasm_shared_##name##_t* wasm_##name##_share(const wasm_##name##_t*); \
  250. WASM_API_EXTERN own wasm_##name##_t* wasm_##name##_obtain(wasm_store_t*, const wasm_shared_##name##_t*);
  251. WASM_DECLARE_REF_BASE(ref)
  252. // Traps
  253. typedef wasm_name_t wasm_message_t; // null terminated
  254. WASM_DECLARE_REF_BASE(trap)
  255. WASM_API_EXTERN own wasm_trap_t* wasm_trap_new(wasm_store_t* store, const wasm_message_t*);
  256. WASM_API_EXTERN void wasm_trap_message(const wasm_trap_t*, own wasm_message_t* out);
  257. // Modules
  258. #ifndef WASM_MODULE_T_DEFINED
  259. #define WASM_MODULE_T_DEFINED
  260. struct WASMModuleCommon;
  261. typedef struct WASMModuleCommon *wasm_module_t;
  262. #endif
  263. WASM_API_EXTERN own wasm_module_t* wasm_module_new(
  264. wasm_store_t*, const wasm_byte_vec_t* binary);
  265. WASM_API_EXTERN bool wasm_module_validate(wasm_store_t*, const wasm_byte_vec_t* binary);
  266. WASM_API_EXTERN void wasm_module_delete(own wasm_module_t*);
  267. WASM_API_EXTERN own wasm_module_t* wasm_module_copy(const wasm_module_t*);
  268. WASM_API_EXTERN bool wasm_module_same(const wasm_module_t*, const wasm_module_t*);
  269. WASM_API_EXTERN void wasm_module_imports(const wasm_module_t*, own wasm_importtype_vec_t* out);
  270. WASM_API_EXTERN void wasm_module_exports(const wasm_module_t*, own wasm_exporttype_vec_t* out);
  271. WASM_API_EXTERN void wasm_module_serialize(const wasm_module_t*, own wasm_byte_vec_t* out);
  272. WASM_API_EXTERN own wasm_module_t* wasm_module_deserialize(wasm_store_t*, const wasm_byte_vec_t*);
  273. // Function Instances
  274. WASM_DECLARE_REF(func)
  275. typedef own wasm_trap_t* (*wasm_func_callback_t)(
  276. const wasm_val_t args[], wasm_val_t results[]);
  277. typedef own wasm_trap_t* (*wasm_func_callback_with_env_t)(
  278. void* env, const wasm_val_t args[], wasm_val_t results[]);
  279. WASM_API_EXTERN own wasm_func_t* wasm_func_new(
  280. wasm_store_t*, const wasm_functype_t*, wasm_func_callback_t);
  281. WASM_API_EXTERN own wasm_func_t* wasm_func_new_with_env(
  282. wasm_store_t*, const wasm_functype_t* type, wasm_func_callback_with_env_t,
  283. void* env, void (*finalizer)(void*));
  284. WASM_API_EXTERN own wasm_functype_t* wasm_func_type(const wasm_func_t*);
  285. WASM_API_EXTERN size_t wasm_func_param_arity(const wasm_func_t*);
  286. WASM_API_EXTERN size_t wasm_func_result_arity(const wasm_func_t*);
  287. WASM_API_EXTERN own wasm_trap_t* wasm_func_call(
  288. const wasm_func_t*, const wasm_val_t args[], wasm_val_t results[]);
  289. // Global Instances
  290. WASM_DECLARE_REF_BASE(global)
  291. WASM_API_EXTERN own wasm_global_t* wasm_global_new(
  292. wasm_store_t*, const wasm_globaltype_t*, const wasm_val_t*);
  293. WASM_API_EXTERN own wasm_globaltype_t* wasm_global_type(const wasm_global_t*);
  294. WASM_API_EXTERN void wasm_global_get(const wasm_global_t*, own wasm_val_t* out);
  295. WASM_API_EXTERN void wasm_global_set(wasm_global_t*, const wasm_val_t*);
  296. // Table Instances
  297. WASM_DECLARE_REF_BASE(table)
  298. typedef uint32_t wasm_table_size_t;
  299. WASM_API_EXTERN own wasm_table_t* wasm_table_new(
  300. wasm_store_t*, const wasm_tabletype_t*, wasm_ref_t* init);
  301. WASM_API_EXTERN own wasm_tabletype_t* wasm_table_type(const wasm_table_t*);
  302. WASM_API_EXTERN own wasm_ref_t* wasm_table_get(const wasm_table_t*, wasm_table_size_t index);
  303. WASM_API_EXTERN bool wasm_table_set(wasm_table_t*, wasm_table_size_t index, wasm_ref_t*);
  304. WASM_API_EXTERN wasm_table_size_t wasm_table_size(const wasm_table_t*);
  305. WASM_API_EXTERN bool wasm_table_grow(wasm_table_t*, wasm_table_size_t delta, wasm_ref_t* init);
  306. // Memory Instances
  307. WASM_DECLARE_REF_BASE(memory)
  308. typedef uint32_t wasm_memory_pages_t;
  309. static const size_t MEMORY_PAGE_SIZE = 0x10000;
  310. WASM_API_EXTERN own wasm_memory_t* wasm_memory_new(wasm_store_t*, const wasm_memorytype_t*);
  311. WASM_API_EXTERN own wasm_memorytype_t* wasm_memory_type(const wasm_memory_t*);
  312. WASM_API_EXTERN byte_t* wasm_memory_data(wasm_memory_t*);
  313. WASM_API_EXTERN size_t wasm_memory_data_size(const wasm_memory_t*);
  314. WASM_API_EXTERN wasm_memory_pages_t wasm_memory_size(const wasm_memory_t*);
  315. WASM_API_EXTERN bool wasm_memory_grow(wasm_memory_t*, wasm_memory_pages_t delta);
  316. // Externals
  317. WASM_DECLARE_REF_BASE(extern)
  318. WASM_DECLARE_VEC(extern, *)
  319. WASM_API_EXTERN wasm_externkind_t wasm_extern_kind(const wasm_extern_t*);
  320. WASM_API_EXTERN own wasm_externtype_t* wasm_extern_type(const wasm_extern_t*);
  321. WASM_API_EXTERN wasm_extern_t* wasm_func_as_extern(wasm_func_t*);
  322. WASM_API_EXTERN wasm_extern_t* wasm_global_as_extern(wasm_global_t*);
  323. WASM_API_EXTERN wasm_extern_t* wasm_table_as_extern(wasm_table_t*);
  324. WASM_API_EXTERN wasm_extern_t* wasm_memory_as_extern(wasm_memory_t*);
  325. WASM_API_EXTERN wasm_func_t* wasm_extern_as_func(wasm_extern_t*);
  326. WASM_API_EXTERN wasm_global_t* wasm_extern_as_global(wasm_extern_t*);
  327. WASM_API_EXTERN wasm_table_t* wasm_extern_as_table(wasm_extern_t*);
  328. WASM_API_EXTERN wasm_memory_t* wasm_extern_as_memory(wasm_extern_t*);
  329. WASM_API_EXTERN const wasm_extern_t* wasm_func_as_extern_const(const wasm_func_t*);
  330. WASM_API_EXTERN const wasm_extern_t* wasm_global_as_extern_const(const wasm_global_t*);
  331. WASM_API_EXTERN const wasm_extern_t* wasm_table_as_extern_const(const wasm_table_t*);
  332. WASM_API_EXTERN const wasm_extern_t* wasm_memory_as_extern_const(const wasm_memory_t*);
  333. WASM_API_EXTERN const wasm_func_t* wasm_extern_as_func_const(const wasm_extern_t*);
  334. WASM_API_EXTERN const wasm_global_t* wasm_extern_as_global_const(const wasm_extern_t*);
  335. WASM_API_EXTERN const wasm_table_t* wasm_extern_as_table_const(const wasm_extern_t*);
  336. WASM_API_EXTERN const wasm_memory_t* wasm_extern_as_memory_const(const wasm_extern_t*);
  337. // Module Instances
  338. WASM_DECLARE_REF_BASE(instance)
  339. WASM_API_EXTERN own wasm_instance_t* wasm_instance_new(
  340. wasm_store_t*, const wasm_module_t*, const wasm_extern_t* const imports[],
  341. own wasm_trap_t**
  342. );
  343. WASM_API_EXTERN void wasm_instance_exports(const wasm_instance_t*, own wasm_extern_vec_t* out);
  344. ///////////////////////////////////////////////////////////////////////////////
  345. // Convenience
  346. // Value Type construction short-hands
  347. static inline own wasm_valtype_t* wasm_valtype_new_i32() {
  348. return wasm_valtype_new(WASM_I32);
  349. }
  350. static inline own wasm_valtype_t* wasm_valtype_new_i64() {
  351. return wasm_valtype_new(WASM_I64);
  352. }
  353. static inline own wasm_valtype_t* wasm_valtype_new_f32() {
  354. return wasm_valtype_new(WASM_F32);
  355. }
  356. static inline own wasm_valtype_t* wasm_valtype_new_f64() {
  357. return wasm_valtype_new(WASM_F64);
  358. }
  359. static inline own wasm_valtype_t* wasm_valtype_new_anyref() {
  360. return wasm_valtype_new(WASM_ANYREF);
  361. }
  362. static inline own wasm_valtype_t* wasm_valtype_new_funcref() {
  363. return wasm_valtype_new(WASM_FUNCREF);
  364. }
  365. // Function Types construction short-hands
  366. static inline own wasm_functype_t* wasm_functype_new_0_0() {
  367. wasm_valtype_vec_t params, results;
  368. wasm_valtype_vec_new_empty(&params);
  369. wasm_valtype_vec_new_empty(&results);
  370. return wasm_functype_new(&params, &results);
  371. }
  372. static inline own wasm_functype_t* wasm_functype_new_1_0(
  373. own wasm_valtype_t* p
  374. ) {
  375. wasm_valtype_t* ps[1] = {p};
  376. wasm_valtype_vec_t params, results;
  377. wasm_valtype_vec_new(&params, 1, ps);
  378. wasm_valtype_vec_new_empty(&results);
  379. return wasm_functype_new(&params, &results);
  380. }
  381. static inline own wasm_functype_t* wasm_functype_new_2_0(
  382. own wasm_valtype_t* p1, own wasm_valtype_t* p2
  383. ) {
  384. wasm_valtype_t* ps[2] = {p1, p2};
  385. wasm_valtype_vec_t params, results;
  386. wasm_valtype_vec_new(&params, 2, ps);
  387. wasm_valtype_vec_new_empty(&results);
  388. return wasm_functype_new(&params, &results);
  389. }
  390. static inline own wasm_functype_t* wasm_functype_new_3_0(
  391. own wasm_valtype_t* p1, own wasm_valtype_t* p2, own wasm_valtype_t* p3
  392. ) {
  393. wasm_valtype_t* ps[3] = {p1, p2, p3};
  394. wasm_valtype_vec_t params, results;
  395. wasm_valtype_vec_new(&params, 3, ps);
  396. wasm_valtype_vec_new_empty(&results);
  397. return wasm_functype_new(&params, &results);
  398. }
  399. static inline own wasm_functype_t* wasm_functype_new_0_1(
  400. own wasm_valtype_t* r
  401. ) {
  402. wasm_valtype_t* rs[1] = {r};
  403. wasm_valtype_vec_t params, results;
  404. wasm_valtype_vec_new_empty(&params);
  405. wasm_valtype_vec_new(&results, 1, rs);
  406. return wasm_functype_new(&params, &results);
  407. }
  408. static inline own wasm_functype_t* wasm_functype_new_1_1(
  409. own wasm_valtype_t* p, own wasm_valtype_t* r
  410. ) {
  411. wasm_valtype_t* ps[1] = {p};
  412. wasm_valtype_t* rs[1] = {r};
  413. wasm_valtype_vec_t params, results;
  414. wasm_valtype_vec_new(&params, 1, ps);
  415. wasm_valtype_vec_new(&results, 1, rs);
  416. return wasm_functype_new(&params, &results);
  417. }
  418. static inline own wasm_functype_t* wasm_functype_new_2_1(
  419. own wasm_valtype_t* p1, own wasm_valtype_t* p2, own wasm_valtype_t* r
  420. ) {
  421. wasm_valtype_t* ps[2] = {p1, p2};
  422. wasm_valtype_t* rs[1] = {r};
  423. wasm_valtype_vec_t params, results;
  424. wasm_valtype_vec_new(&params, 2, ps);
  425. wasm_valtype_vec_new(&results, 1, rs);
  426. return wasm_functype_new(&params, &results);
  427. }
  428. static inline own wasm_functype_t* wasm_functype_new_3_1(
  429. own wasm_valtype_t* p1, own wasm_valtype_t* p2, own wasm_valtype_t* p3,
  430. own wasm_valtype_t* r
  431. ) {
  432. wasm_valtype_t* ps[3] = {p1, p2, p3};
  433. wasm_valtype_t* rs[1] = {r};
  434. wasm_valtype_vec_t params, results;
  435. wasm_valtype_vec_new(&params, 3, ps);
  436. wasm_valtype_vec_new(&results, 1, rs);
  437. return wasm_functype_new(&params, &results);
  438. }
  439. static inline own wasm_functype_t* wasm_functype_new_0_2(
  440. own wasm_valtype_t* r1, own wasm_valtype_t* r2
  441. ) {
  442. wasm_valtype_t* rs[2] = {r1, r2};
  443. wasm_valtype_vec_t params, results;
  444. wasm_valtype_vec_new_empty(&params);
  445. wasm_valtype_vec_new(&results, 2, rs);
  446. return wasm_functype_new(&params, &results);
  447. }
  448. static inline own wasm_functype_t* wasm_functype_new_1_2(
  449. own wasm_valtype_t* p, own wasm_valtype_t* r1, own wasm_valtype_t* r2
  450. ) {
  451. wasm_valtype_t* ps[1] = {p};
  452. wasm_valtype_t* rs[2] = {r1, r2};
  453. wasm_valtype_vec_t params, results;
  454. wasm_valtype_vec_new(&params, 1, ps);
  455. wasm_valtype_vec_new(&results, 2, rs);
  456. return wasm_functype_new(&params, &results);
  457. }
  458. static inline own wasm_functype_t* wasm_functype_new_2_2(
  459. own wasm_valtype_t* p1, own wasm_valtype_t* p2,
  460. own wasm_valtype_t* r1, own wasm_valtype_t* r2
  461. ) {
  462. wasm_valtype_t* ps[2] = {p1, p2};
  463. wasm_valtype_t* rs[2] = {r1, r2};
  464. wasm_valtype_vec_t params, results;
  465. wasm_valtype_vec_new(&params, 2, ps);
  466. wasm_valtype_vec_new(&results, 2, rs);
  467. return wasm_functype_new(&params, &results);
  468. }
  469. static inline own wasm_functype_t* wasm_functype_new_3_2(
  470. own wasm_valtype_t* p1, own wasm_valtype_t* p2, own wasm_valtype_t* p3,
  471. own wasm_valtype_t* r1, own wasm_valtype_t* r2
  472. ) {
  473. wasm_valtype_t* ps[3] = {p1, p2, p3};
  474. wasm_valtype_t* rs[2] = {r1, r2};
  475. wasm_valtype_vec_t params, results;
  476. wasm_valtype_vec_new(&params, 3, ps);
  477. wasm_valtype_vec_new(&results, 2, rs);
  478. return wasm_functype_new(&params, &results);
  479. }
  480. // Value construction short-hands
  481. static inline void wasm_val_init_ptr(own wasm_val_t* out, void* p) {
  482. #if UINTPTR_MAX == UINT32_MAX
  483. out->kind = WASM_I32;
  484. out->of.i32 = (intptr_t)p;
  485. #elif UINTPTR_MAX == UINT64_MAX
  486. out->kind = WASM_I64;
  487. out->of.i64 = (intptr_t)p;
  488. #endif
  489. }
  490. static inline void* wasm_val_ptr(const wasm_val_t* val) {
  491. #if UINTPTR_MAX == UINT32_MAX
  492. return (void*)(intptr_t)val->of.i32;
  493. #elif UINTPTR_MAX == UINT64_MAX
  494. return (void*)(intptr_t)val->of.i64;
  495. #endif
  496. }
  497. ///////////////////////////////////////////////////////////////////////////////
  498. #undef own
  499. #ifdef __cplusplus
  500. } // extern "C"
  501. #endif
  502. #endif // #ifdef WASM_H