wasm_c_api.h 21 KB

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