当前位置：首页 > news >正文

rust语言String转C语言原生*mut c_char

news 2026/6/13 13:11:16

要将 Rust 的 String 转换为 C 语言原生的 *mut c_char 指针，您需要使用 std::ffi::CString 和一些 unsafe 代码。这个过程涉及所有权转移和手动内存管理，是 Rust FFI（外部函数接口）的核心部分。

核心步骤

转换为 CString：确保字符串以 C 语言要求的空字符（\0）结尾，并且内部不含空字符。
获取裸指针：使用 into_raw() 方法，它会消耗 CString 的所有权，返回一个 *mut c_char 指针。
内存管理（关键）：您的 C 语言代码现在拥有这块内存。您必须提供一个函数，以便 C 语言在使用完毕后将所有权交还给 Rust，由 Rust 负责释放内存。

完整示例代码

这是一个完整的 Rust 模块示例，包含了分配和释放内存所需的函数：

rust

use std::ffi::CString;
use std::os::raw::c_char; // C 语言的 char 类型别名// 这是一个使用 #[no_mangle] 标记的函数，可以被外部 C 代码调用
#[no_mangle]
pub extern "C" fn allocate_c_string(s: String) -> *mut c_char {// 1. 将 Rust String 转换为 CStringlet c_string = CString::new(s).expect("String 不能包含内部的空字符 (\\0)");// 2. 使用 into_raw() 消耗 CString，返回裸指针 *mut c_char// 现在 C 代码负责管理这个指针指向的内存c_string.into_raw()
}// 这是一个配套的函数，用于安全地释放 C 代码使用完的指针
#[no_mangle]
pub extern "C" fn free_c_string(ptr: *mut c_char) {// 必须在 unsafe 块中操作裸指针if !ptr.is_null() {unsafe {// 使用 CString::from_raw() 重新获取 CString 的所有权。// 当 from_raw() 创建的临时 CString 在作用域结束时，// 它的 Drop Trait 会自动运行，安全地释放内存。let _ = CString::from_raw(ptr);}}
}fn main() {let rust_string = String::from("Hello from Rust FFI!");// 示例如何调用：let c_ptr = allocate_c_string(rust_string);println!("获取到 C 指针: {:?}", c_ptr);// ... 在这里，C 语言代码可以使用 c_ptr ...// 当 C 语言使用完毕后，调用释放函数free_c_string(c_ptr);
}

Use code with caution.

使用要点

extern "C"：确保函数使用 C 语言的调用约定（ABI）。
#[no_mangle]：告诉 Rust 编译器不要改变函数名称，确保 C 编译器能找到 allocate_c_string 和 free_c_string。
CString::into_raw()：关键操作，它将所有权转移到返回的裸指针。
CString::from_raw()：关键操作，它接收裸指针的所有权，并在安全作用域内触发 Rust 的 Drop 机制来释放内存。