bindgen
是一个 Rust 库,用于从 C 语言的头文件生成 Rust 绑定。要正确运用 bindgen
,请按照以下步骤操作:
- 首先,确保你已经安装了 Rust 和
bindgen
。如果没有,请访问 Rust 官方网站 安装 Rust,然后使用以下命令安装bindgen
:
cargo install bindgen
- 创建一个新的 Rust 项目(如果你还没有一个):
cargo new my_project cd my_project
- 在项目的
Cargo.toml
文件中,添加bindgen
作为依赖项:
[dependencies] bindgen = "0.59.2"
- 创建一个名为
wrapper.h
的 C 语言头文件,其中包含你想要从 Rust 访问的函数和类型声明:
// wrapper.h #ifndef WRAPPER_H #define WRAPPER_H int add(int a, int b); #endif // WRAPPER_H
- 在项目的
src
目录下创建一个名为build.rs
的文件,用于编写构建脚本。在这个文件中,我们将使用bindgen
生成 Rust 绑定:
// build.rs extern crate bindgen; use std::env; use std::path::PathBuf; fn main() { // 指定头文件的路径 let bindings = bindgen::Builder::default() .header("wrapper.h") .generate() .expect("Unable to generate bindings"); // 将生成的绑定写入一个 Rust 文件 let out_path = PathBuf::from(env::var("CARGO_MANIFEST_DIR").unwrap()); bindings .write_to_file(out_path.join("bindings.rs")) .expect("Couldn't write bindings!"); }
- 在
src
目录下创建一个名为main.rs
的文件,用于编写 Rust 代码。在这个文件中,我们将使用生成的绑定来调用 C 语言函数:
// src/main.rs mod bindings; fn main() { let a = 5; let b = 7; let result = bindings::add(a, b); println!("The sum of {} and {} is {}", a, b, result); }
- 现在,你可以使用
cargo build
命令构建项目。这将自动运行build.rs
脚本,生成bindings.rs
文件,然后编译main.rs
文件。如果一切顺利,你将看到输出 “The sum of 5 and 7 is 12”。
这就是如何使用 bindgen
从 C 语言头文件生成 Rust 绑定的基本方法。你可以根据需要调整 wrapper.h
和 build.rs
文件以适应你的项目。