mirror of
https://github.com/bytecodealliance/wasm-micro-runtime.git
synced 2025-05-09 21:26:21 +00:00
b256cb3a53
Update README.md, add "Getting Started", “Performance and Footprint”, ”Use Cases", and refine some sections. Add memory tune document and fix wasm-c-api document.
42 lines
1.3 KiB
Markdown
42 lines
1.3 KiB
Markdown
# wasm-c-api introduction
|
|
|
|
All samples come from the commit 340fd9528cc3b26d22fe30ee1628c8c3f2b8c53b
|
|
of [wasm-c-api](https://github.com/WebAssembly/wasm-c-api).
|
|
|
|
Developer can learn these *APIs* from
|
|
[wasm.h](https://github.com/WebAssembly/wasm-c-api/blob/master/include/wasm.h).
|
|
|
|
And here are [examples](https://github.com/WebAssembly/wasm-c-api/tree/master/example) which
|
|
are helpful.
|
|
|
|
Currently WAMR supports most of the APIs, the unsupported APIs are listed as below:
|
|
|
|
- References
|
|
|
|
``` c
|
|
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
|
|
|
|
``` c
|
|
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
|
|
|
|
``` c
|
|
WASM_API_EXTERN bool wasm_table_grow(wasm_table_t*, wasm_table_size_t delta, wasm_ref_t* init);
|
|
```
|
|
|
|
- Memory Grow APIs
|
|
|
|
``` c
|
|
WASM_API_EXTERN bool wasm_memory_grow(wasm_memory_t*, wasm_memory_pages_t delta);
|
|
```
|