Rust FFI与C交互：跨语言编程实践

Rust FFI与C交互跨语言编程实践引言大家好我是一名正在从Rust转向Python的后端开发者。在实际项目中我们经常需要与其他语言进行交互特别是C语言。Rust提供了强大的FFIForeign Function Interface支持可以方便地与C代码进行互操作。今天我想和大家分享一下我在Rust FFI编程方面的经验。FFI基础什么是FFIFFI是一种机制允许不同编程语言之间相互调用。Rust的FFI主要用于调用C库被其他语言调用与系统API交互基本概念// 外部函数声明 extern C { fn printf(format: *const i8, ...) - i32; } fn main() { unsafe { printf(Hello from C!\n\0.as_ptr()); } }调用C函数简单示例use std::os::raw::c_int; extern C { fn abs(x: c_int) - c_int; } fn main() { unsafe { let result abs(-42); println!(abs(-42) {}, result); // 42 } }传递字符串use std::os::raw::c_char; use std::ffi::CString; extern C { fn puts(s: *const c_char) - c_int; } fn main() { let c_str CString::new(Hello from Rust!).unwrap(); unsafe { puts(c_str.as_ptr()); } }传递数组use std::os::raw::{c_int, c_float}; extern C { fn process_array(arr: *const c_float, len: c_int); } fn main() { let arr [1.0f32, 2.0f32, 3.0f32, 4.0f32, 5.0f32]; unsafe { process_array(arr.as_ptr(), arr.len() as c_int); } }导出Rust函数给C基本示例#[no_mangle] pub extern C fn add(a: i32, b: i32) - i32 { a b } #[no_mangle] pub extern C fn greet(name: *const u8) { let name_str unsafe { std::ffi::CStr::from_ptr(name as *const i8).to_str().unwrap() }; println!(Hello, {}!, name_str); }导出结构体#[repr(C)] pub struct Point { x: f64, y: f64, } #[no_mangle] pub extern C fn create_point(x: f64, y: f64) - Point { Point { x, y } } #[no_mangle] pub extern C fn distance(p1: Point, p2: Point) - f64 { ((p1.x - p2.x).powi(2) (p1.y - p2.y).powi(2)).sqrt() }内存管理分配和释放内存use std::ffi::CString; use std::os::raw::c_char; #[no_mangle] pub extern C fn create_string() - *mut c_char { let s CString::new(Hello from Rust).unwrap(); s.into_raw() } #[no_mangle] pub extern C fn free_string(s: *mut c_char) { unsafe { if !s.is_null() { let _ CString::from_raw(s); } } }使用libc分配器use libc::{malloc, free, c_void}; use std::ptr; fn main() { unsafe { let ptr malloc(1024) as *mut i32; if !ptr.is_null() { *ptr 42; println!(Value: {}, *ptr); free(ptr as *mut c_void); } } }实际应用场景场景1封装C库use std::ffi::CString; use std::os::raw::c_char; extern C { fn sqlite3_open(filename: *const c_char, db: *mut *mut sqlite3) - c_int; fn sqlite3_close(db: *mut sqlite3) - c_int; } struct SqliteDb { db: *mut sqlite3, } impl SqliteDb { fn open(filename: str) - ResultSelf, String { let c_filename CString::new(filename).map_err(|e| e.to_string())?; let mut db: *mut sqlite3 ptr::null_mut(); let result unsafe { sqlite3_open(c_filename.as_ptr(), mut db) }; if result ! 0 || db.is_null() { return Err(Failed to open database.to_string()); } Ok(Self { db }) } } impl Drop for SqliteDb { fn drop(mut self) { if !self.db.is_null() { unsafe { sqlite3_close(self.db) }; } } }场景2高性能计算库use std::os::raw::c_float; #[no_mangle] pub extern C fn matrix_multiply( a: *const c_float, b: *const c_float, result: *mut c_float, n: usize, ) { unsafe { for i in 0..n { for j in 0..n { let mut sum 0.0f32; for k in 0..n { sum *a.add(i * n k) * *b.add(k * n j); } *result.add(i * n j) sum; } } } }场景3回调函数use std::os::raw::{c_int, c_char}; use std::ffi::CStr; type Callback extern C fn(c_int, *const c_char); extern C fn process_items(callback: Callback) { let items [1, 2, 3, 4, 5]; for (i, item) in items.iter().enumerate() { let msg format!(Item {}, item); let c_msg std::ffi::CString::new(msg).unwrap(); callback(i as c_int, c_msg.as_ptr()); } }构建静态库和动态库静态库[lib] name mylib crate-type [staticlib]cargo build --release动态库[lib] name mylib crate-type [cdylib]cargo build --release实战项目Rust日志库供C使用use std::ffi::CStr; use std::os::raw::c_char; #[repr(C)] pub enum LogLevel { Debug, Info, Warning, Error, } #[no_mangle] pub extern C fn rust_log(level: LogLevel, message: *const c_char) { let message_str unsafe { CStr::from_ptr(message).to_str().unwrap_or(Invalid string) }; match level { LogLevel::Debug println!([DEBUG] {}, message_str), LogLevel::Info println!([INFO] {}, message_str), LogLevel::Warning println!([WARN] {}, message_str), LogLevel::Error eprintln!([ERROR] {}, message_str), } } #[no_mangle] pub extern C fn rust_log_fmt(level: LogLevel, format: *const c_char, ...) { use std::ffi::CString; use std::fmt::Write; let format_str unsafe { CStr::from_ptr(format).to_str().unwrap_or(Invalid format) }; let mut message String::new(); let _ write!(message, {}, format_str); rust_log(level, CString::new(message).unwrap().as_ptr()); }与Python C扩展的对比特性Rust FFIPython C扩展内存安全编译时保证手动管理类型安全编译时检查运行时检查性能零开销有一定开销互操作性与C无缝与C无缝学习曲线较陡峭相对简单总结Rust的FFI系统提供了强大的跨语言交互能力调用C库可以轻松调用现有的C库导出函数可以将Rust函数导出给C使用内存管理需要谨慎处理内存分配和释放性能零运行时开销性能优异通过合理使用FFI我们可以复用现有的C代码为其他语言提供高性能的Rust库与系统API进行交互作为从Rust转向Python的开发者我发现Rust的FFI系统比Python的C扩展更加安全和高效。虽然需要注意内存管理但类型安全带来的好处是巨大的。延伸阅读Rust官方文档 - FFIRust By Example - FFIThe Rust FFI Omnibus