bindgen
是一个 Rust 库,用于从 C 语言的头文件生成 Rust 绑定。要正确运用 bindgen
,请按照以下步骤操作:
bindgen
。如果没有,请访问 Rust 官方网站 安装 Rust,然后使用以下命令安装 bindgen
:cargo install bindgen
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
文件以适应你的项目。