wasm-micro-runtime/doc/wasm_c_api.md

wasm-c-api introduction

All samples come from the commit 340fd9528c of wasm-c-api.

Developer can learn these APIs from wasm.h.

And here are examples which are helpful.

Currently WAMR supports most of the APIs, the unsupported APIs are listed as below:

• References

  WASM_API_EXTERN own wasm_shared_##name##_t* wasm_##name##_share(const wasm_##name##_t*);
  WASM_API_EXTERN own wasm_##name##_t* wasm_##name##_obtain(wasm_store_t*, const wasm_shared_##name##_t*);
  

• Several Module APIs

  WASM_API_EXTERN void wasm_module_serialize(const wasm_module_t*, own wasm_byte_vec_t* out);
  WASM_API_EXTERN own wasm_module_t* wasm_module_deserialize(wasm_store_t*, const wasm_byte_vec_t*);
  

Currently growing a table or memory by wasm opcode is supported and it is not supported to grow them by host-side function callings.

• Table Grow APIs

  WASM_API_EXTERN bool wasm_table_grow(wasm_table_t*, wasm_table_size_t delta, wasm_ref_t* init);
  

• Memory Grow APIs

  WASM_API_EXTERN bool wasm_memory_grow(wasm_memory_t*, wasm_memory_pages_t delta);