调用与构建 / 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.6 文档整理 · MIT
SereinTeam