Convert your Rust Futures into a FFI-compatible struct without relying unstable Rust ABI and struct layout.
Easily provide async functions in dynamic library maybe compiled with different Rust than the invoker.
See documentation for more details.
Provide some async functions in library: (plugin side)
``rust
// Compile withcrate-type = ["cdylib"]`.
use async_ffi::{FfiFuture, FutureExt};
pub extern "C" fn work(arg: u32) -> FfiFuture
Execute async functions from external library: (host or executor side) ```rust use async_ffi::{FfiFuture, FutureExt};
extern "C" {
#[no_mangle]
fn work(arg: u32) -> FfiFuture
async fn run_work(arg: u32) -> u32 { unsafe { work(arg).await } } ```
By default FfiFuture requires the original Future to be Send.
In case of single-threaded runtime or target (like wasm32-none-none), we may need to relax this requirement.
So we have LocalFfiFuture, which is the almost the same as FfiFuture but without Send requirement.
``rust
// Compile withcrate-type = ["cdylib"], targetingwasm32-none-none`.
use async_ffi::{LocalFfiFuture, FutureExt};
pub extern "C" fn work(arg: u32) -> LocalFfiFuture
MIT Licensed.