rust bindgen 如何正确运用

发布时间:2024-12-03 19:58:31

阅读量:123

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);
}