Rust调用C动态库

Rust调用C动态库

环境

rust: 1.83.0(2024-11-26)
bindgen: 0.71.1
cmake: 3.26.4

1. rust bindgen

bindgen 是一个能自动为 C(或 C++)库生成 Rust 绑定的辅助库和命令行工具。C++ (目前)的支持并不完整。

也就是说,bindgen 可以作为一个 crate,与 Cargo 的 build.rs 机制配合,根据 C/C++ 的头文件(.h, .hpp),在构建阶段,编译主体 Rust 代码之前,自动生成 Rust 绑定文件。

2. 安装bindgen

cargo install bindgen-cli

3. 编写及编译C静态库

  • example.h

    #ifndef EXAMPLE_H
    #define EXAMPLE_H

    #ifdef _WIN32
    #define DLL_EXPORT __declspec(dllexport)
    #else
    #define DLL_EXPORT
    #endif

    DLL_EXPORT int add(int a, int b);

    #endif

  • example.c

    #include "example.h"

    int add(int a, int b)
    {
    return a + b;
    }

  • CMakeLists.txt

    cmake_minimum_required(VERSION 3.8.2)

    project(example)

    add_library(${PROJECT_NAME} SHARED example.c)

    add_library(${PROJECT_NAME} STATIC example.c)

生成c动态库

$ cmake -B bin
$ cmake --build bin --config Release

4. bindgen生成rust绑定文件

bindgen需要用到libcang,设置环境变量LIBCLANG_PATH

set LIBCLANG_PATH=D:/Program Files/LLVM/bin

生成rust绑定文件bindings.rs

bindgen example.h -o bindings.rs

5. rust调用绑定文件

目录结构

$ tree
.
+--- bin
|   +--- Release
|   |   +--- example.dll
|   |   +--- example.lib
+--- bindings.rs
+--- CMakeLists.txt
+--- example
|   +--- Cargo.toml
|   +--- example.lib
|   +--- src
|   |   +--- main.rs
|   +--- target
|   |   +--- release
|   |   |   +--- example.dll
|   |   |   +--- example.exe
+--- example.c
+--- example.h
  • 新建example项目

    cargo new example

  • 复制example.lib到example目录

    cmake -E copy bin/Release/example.lib example

  • 修改example/src/main.rs

    mod bindings {
    include!("../../bindings.rs");
    }

    use bindings::*;

    #[link(name = "example")]
    extern "C" {}

    fn main() {
    unsafe {
    let sum = add(1, 2);
    println!("1 + 2 = {}", sum);
    }
    }

编译

cd example
cargo build -r

运行

拷贝example.dll到程序运行目录

cmake -E copy bin/Release/example.dll example/target/release

执行

$ cargo run -r
    Finished `release` profile [optimized] target(s) in 0.03s
     Running `target\release\example.exe`
1 + 2 = 3
相关推荐
李白同学6 小时前
【C语言】结构体内存对齐问题
c语言·开发语言
楼台的春风7 小时前
【MCU驱动开发概述】
c语言·驱动开发·单片机·嵌入式硬件·mcu·自动驾驶·嵌入式
编程星空10 小时前
css主题色修改后会多出一个css吗?css怎么定义变量?
开发语言·后端·rust
waicsdn_haha16 小时前
Visual Studio Code 2025 安装与高效配置教程
c语言·ide·windows·vscode·微软·编辑器·win7
----云烟----16 小时前
C/C++ 中 volatile 关键字详解
c语言·开发语言·c++
BanLul17 小时前
进程与线程 (三)——线程间通信
c语言·开发语言·算法
落羽的落羽17 小时前
【落羽的落羽 数据结构篇】栈和队列
c语言·数据结构
Hello.Reader17 小时前
深入理解 Rust 的 `Rc<T>`:实现多所有权的智能指针
开发语言·后端·rust
yoona102017 小时前
Rust编程语言入门教程(八)所有权 Stack vs Heap
开发语言·后端·rust·区块链·学习方法
谏君之19 小时前
C语言实现的常见算法示例
c语言·算法·排序算法