rust-bindgen

项目介绍：rust-bindgen

什么是rust-bindgen？

bindgen是一个自动生成Rust FFI（Foreign Function Interface）绑定到C（以及部分C++）库的工具。在软件开发中，FFI允许一个语言编写的程序调用另一个语言编写的程序组件。Rust是一个对内存安全性和并发性有严格要求的现代编程语言，而许多现有的高性能库都是用C语言编写的。bindgen的任务就是架起这两者之间的桥梁，让开发者可以在Rust中顺利调用C语言编写的功能代码。

使用示例

假设有一个C头文件doggo.h，其中定义了一个结构和一个函数：

typedef struct Doggo {
    int many;
    char wow;
} Doggo;

void eleven_out_of_ten_majestic_af(Doggo* pupper);

使用bindgen工具，可以自动生成Rust中的FFI代码，便于调用该C库的功能：

#[repr(C)]
pub struct Doggo {
    pub many: ::std::os::raw::c_int,
    pub wow: ::std::os::raw::c_char,
}

extern "C" {
    pub fn eleven_out_of_ten_majestic_af(pupper: *mut Doggo);
}

用户指导

bindgen有详细的用户指南，帮助开发者更好地使用其功能。在用户指南中，包含了如何安装、配置和使用bindgen的详细说明。

最低支持的Rust版本

bindgen要求的最低Rust版本是1.70.0。同样，bindgen-cli也是要求1.70.0版本。虽然具体的最低版本政策还未定，但随着发布的推进，可能会对这个版本有调整。不过，生成的绑定通常能够兼容低于此版本的Rust环境。

环境变量配置

bindgen允许通过环境变量来修改其行为，这样用户无需改变调用bindgen的项目源代码即可灵活地调整配置。

BINDGEN_EXTRA_CLANG_ARGS：传递给clang的额外参数，可以用来指定不同的系统根目录或添加搜索路径。
BINDGEN_EXTRA_CLANG_ARGS_<TARGET>：类似于BINDGEN_EXTRA_CLANG_ARGS，但适用于为特定目标的clang配置，主要用于交叉编译环境。

bindgen依赖libclang来解析C和C++头文件，通过合适的环境配置可以控制libclang的查找路径。