Rust FFI 编程 - Rust导出共享库06

2024-06-23 00:08
文章标签 rust 共享 编程 导出 06 ffi

本文主要是介绍Rust FFI 编程 - Rust导出共享库06,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

本节主要介绍 Rust 导出共享库时,如何通过指针在 Rust 和 C 之间传递结构体。上一节的示例是结构体的内存在 C 端分配,本节介绍内存在 Rust 这边分配,由 C 填充和使用。

设计

本节的示例:

  • Rust 中导出共享库,包含三个函数:

    • student_new,Rust 端分配内存并用默认值初始化,由 C 端填充和更新;

    • student_alice,Rust 端分配内存并初始化,由 C 端使用;

    • student_free,供 C 端用来释放结构体的内存

  • C 中定义main函数,链接 Rust 的共享库,并调用相关函数;

实现

工程的初始化类似之前的导出共享库示例,导出.so的共享库要在Cargo.toml中加上:

[lib]
crate-type = ["cdylib"]

下面我们直接看示例的代码。

首先,在 Rust 端和 C 头文件中定义声明要传递的结构体。

// src/lib.rs
#[repr(C)]
#[derive(Debug)]
pub struct Student {pub num: c_int,pub total: c_int,pub name: [c_char; 20],pub scores: [c_float; 3],
}
// src/example_03.h
typedef struct Student
{int num;int total;char name[20];float scores[3];
} Student;

其次在 Rust 端实现我们设计的三个函数。

#[no_mangle]
pub extern "C" fn student_new() -> *mut Student {let new_stu: Student = Default::default();Box::into_raw(Box::new(new_stu))
}#[no_mangle]
pub extern "C" fn student_alice() -> *mut Student {let mut init_char_array: [c_char; 20] = [0; 20];for (dest, src) in init_char_array.iter_mut().zip(b"Alice\0".iter()) {*dest = *src as _;}let scores = [92.5, 87.5, 90.0];let alice = Student {num: 001,total: 280,name: init_char_array,scores,};Box::into_raw(Box::new(alice))
}#[no_mangle]
pub extern "C" fn student_free(p_stu: *mut Student) {if !p_stu.is_null() {unsafe {println!("rust side print: {:?}", Box::from_raw(p_stu));Box::from_raw(p_stu)};}
}

其中一个比较有挑战的地方是,要传递的结构体Student中有个固定长度的c_char数组。如何在 Rust 中初始化它并为其赋值呢?

我们知道 Rust 中的c_char表示 C 中的字符char,但 C 的char类型(表示一个整数)完全不同于 Rust 的char类型(表示一个 Unicode 标量值),所以在 Rust 中的c_char实际上是i8/u8

let mut init_char_array: [c_char; 20] = [0; 20];
for (dest, src) in init_char_array.iter_mut().zip(b"Alice\0".iter()) {*dest = *src as _;
}

这里我们通过zip函数一次遍历两个数组,并完成赋值。

接下来我们在 C 的头文件中声明这三个函数,并看看 C 端的调用代码。

// csrc/main.cint main(void) {Student *c_ptr = student_alice();printf("Student Num: %d\t Total: %d\t Name: %s\t\n", c_ptr->num, c_ptr->total, c_ptr->name);student_free(c_ptr);Student *stu = student_new();printf("Before fill data: Student Num: %d\t Total: %d\t Name: %s\t Scores: %.1f\t%.1f\t%.1f\n",stu->num, stu->total, stu->name,stu->scores[0], stu->scores[1], stu->scores[2]);stu->num = 2;stu->total = 212;strcpy(stu->name, "Bob");stu->scores[0] = 60.6;stu->scores[1] = 70.7;stu->scores[2] = 80.8;printf("After fill data: Student Num: %d\t Total: %d\t Name: %s\t Scores: %.1f\t%.1f\t%.1f\n",stu->num, stu->total, stu->name,stu->scores[0], stu->scores[1], stu->scores[2]);student_free(stu);return 0;
}

我们编写Makefile,编译并运行。结果如下:

➜  example_03 git:(master) ✗ make
/data/cargo/bin/cargo clean
rm -f ./csrc/main
/data/cargo/bin/cargo build --releaseCompiling example_03 v0.1.0 (/data/github/lester/rust-practice/ffi/example_03)Finished release [optimized] target(s) in 0.39s
/usr/bin/gcc -o ./csrc/main ./csrc/main.c -Isrc -L. -l:target/release/libexample_03.so
./csrc/main
Student Num: 1   Total: 280      Name: Alice
rust side print: Student { num: 1, total: 280, name: [65, 108, 105, 99, 101, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0], scores: [92.5, 87.5, 90.0] }
Before fill data: Student Num: 0         Total: 0        Name:   Scores: 0.0    0.0     0.0
After fill data: Student Num: 2  Total: 212      Name: Bob       Scores: 60.6   70.7    80.8
rust side print: Student { num: 2, total: 212, name: [66, 111, 98, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0], scores: [60.6, 70.7, 80.8] }

我们可以看出,Rust 端分配内存并初始化的结构体,在 C 端可以被完美地使用和更新,要注意的是在调用后,需要调用student_free函数来释放结构体的内存。

结论

本文通过设计一个示例,演示了 Rust 导出共享库时,提供内存分配和释放的函数,通过指针传递结构体,并在 C 端完美实现使用和更新结构体。

本章示例的所有代码:https://github.com/lesterli/rust-practice/tree/master/ffi/example_03。

这篇关于Rust FFI 编程 - Rust导出共享库06的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1085791

相关文章

Python将博客内容html导出为Markdown格式

《Python将博客内容html导出为Markdown格式》Python将博客内容html导出为Markdown格式,通过博客url地址抓取文章,分析并提取出文章标题和内容,将内容构建成html,再转... 目录一、为什么要搞?二、准备如何搞?三、说搞咱就搞!抓取文章提取内容构建html转存markdown

vue使用docxtemplater导出word

《vue使用docxtemplater导出word》docxtemplater是一种邮件合并工具,以编程方式使用并处理条件、循环,并且可以扩展以插入任何内容,下面我们来看看如何使用docxtempl... 目录docxtemplatervue使用docxtemplater导出word安装常用语法 封装导出方

揭秘Python Socket网络编程的7种硬核用法

《揭秘PythonSocket网络编程的7种硬核用法》Socket不仅能做聊天室,还能干一大堆硬核操作,这篇文章就带大家看看Python网络编程的7种超实用玩法,感兴趣的小伙伴可以跟随小编一起... 目录1.端口扫描器:探测开放端口2.简易 HTTP 服务器:10 秒搭个网页3.局域网游戏:多人联机对战4.

Java并发编程必备之Synchronized关键字深入解析

《Java并发编程必备之Synchronized关键字深入解析》本文我们深入探索了Java中的Synchronized关键字,包括其互斥性和可重入性的特性,文章详细介绍了Synchronized的三种... 目录一、前言二、Synchronized关键字2.1 Synchronized的特性1. 互斥2.

Linux samba共享慢的原因及解决方案

《Linuxsamba共享慢的原因及解决方案》:本文主要介绍Linuxsamba共享慢的原因及解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录linux samba共享慢原因及解决问题表现原因解决办法总结Linandroidux samba共享慢原因及解决

java中使用POI生成Excel并导出过程

《java中使用POI生成Excel并导出过程》:本文主要介绍java中使用POI生成Excel并导出过程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录需求说明及实现方式需求完成通用代码版本1版本2结果展示type参数为atype参数为b总结注:本文章中代码均为

Python实现将MySQL中所有表的数据都导出为CSV文件并压缩

《Python实现将MySQL中所有表的数据都导出为CSV文件并压缩》这篇文章主要为大家详细介绍了如何使用Python将MySQL数据库中所有表的数据都导出为CSV文件到一个目录,并压缩为zip文件到... python将mysql数据库中所有表的数据都导出为CSV文件到一个目录,并压缩为zip文件到另一个

Python异步编程中asyncio.gather的并发控制详解

《Python异步编程中asyncio.gather的并发控制详解》在Python异步编程生态中,asyncio.gather是并发任务调度的核心工具,本文将通过实际场景和代码示例,展示如何结合信号量... 目录一、asyncio.gather的原始行为解析二、信号量控制法:给并发装上"节流阀"三、进阶控制

Java导入、导出excel用法步骤保姆级教程(附封装好的工具类)

《Java导入、导出excel用法步骤保姆级教程(附封装好的工具类)》:本文主要介绍Java导入、导出excel的相关资料,讲解了使用Java和ApachePOI库将数据导出为Excel文件,包括... 目录前言一、引入Apache POI依赖二、用法&步骤2.1 创建Excel的元素2.3 样式和字体2.

java导出pdf文件的详细实现方法

《java导出pdf文件的详细实现方法》:本文主要介绍java导出pdf文件的详细实现方法,包括制作模板、获取中文字体文件、实现后端服务以及前端发起请求并生成下载链接,需要的朋友可以参考下... 目录使用注意点包含内容1、制作pdf模板2、获取pdf导出中文需要的文件3、实现4、前端发起请求并生成下载链接使