調用與構建 / FFI 與導出

FFI 與導出

extern "C":調用 C 函數

extern "C" fn strlen(s: str) -> i64;

print(strlen("hello"));   // 5

聲明外部 C 函數後直接調用。

#[export]:導出 C ABI 符號

把函數變成動態庫中可見的 C ABI 符號,配合 --shared:

#[export]
fn add(a: i64, b: i64) -> i64 {
    return a + b;
}

約束

不能泛型須單態化
不能與 extern "C" 混用—
參數限制i32 / i64 / f64 / bool / str / String / *T
返回值同上或無返回

#[py_export]:導出 Python

在 #[export] 基礎上自動生成 CPython 膠水層,詳見導出 Python 模塊。

鏈接外部庫

[dependencies]
sqlite = { path = "../deps/aero-sqlite" }

[link]
lib_paths = ["../deps/aero-sqlite"]
libs = ["sqlite3"]

FFI 依賴路徑用相對路徑,保證跨機器可移植。aero-sqlite 自帶 libsqlite3.a,安裝即用,無需 C 工具鏈。

Aero 文档 · 基于 Aero 1.2.0 文档整理 · MIT
SereinTeam