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

rust与c语言字符串相互转换总结

news 2026/5/12 12:43:11

在 Rust 中，String 和 CString 分别用于不同的目的，因此它们的转换涉及内存布局和所有权的变化。

String：Rust 原生的、UTF-8 编码的、动态增长的字符串智能指针。
CString：与 C 语言兼容的字符串智能指针。它是一个以空字符（Null Terminator, \0）结尾的字节序列。

1. `String` 转换为 `CString`

使用 CString::new() 方法。此操作可能会失败，因此返回一个 Result。

为什么会失败？

C 语言字符串要求空字符 \0 只能出现在字符串的末尾。如果你的 String 中间包含了 \0，CString::new() 会返回一个 Err(NulError)。

use std::ffi::CString;fn rust_to_c(data: String) -> CString {// CString::new 返回 Result，需要使用 expect 或 match 来处理错误let c_string = CString::new(data).expect("String 不能包含内部空字符（\\0）");c_string
}fn main() {let s = String::from("Hello, C world!");let c_str = rust_to_c(s);println!("CString 成功创建: {:?}", c_str);// let bad_s = String::from("Null\0Byte");// CString::new(bad_s).expect("这将导致程序崩溃"); 
}

2. `CString` 转换为 `String`

有两种主要方式，取决于你是想获取所有权还是仅获取引用。

A. 获取所有权 (将 CString 消费掉)

使用 .into_string() 方法。此操作也返回一个 Result。

为什么会失败？

虽然 CString 保证以 \0 结尾，但它不保证其内部字节是有效的 UTF-8 编码。String 必须是有效的 UTF-8。如果字节无效，会返回 Err(IntoStringError)。

use std::ffi::CString;fn c_to_rust_owned(c_string: CString) -> String {// 将 CString 转换为 String，并消费掉 CStringlet rust_string = c_string.into_string().expect("CString 不是有效的 UTF-8 编码");rust_string
}// 完整示例结合：
let s = String::from("Hello");
let c_str = CString::new(s).unwrap();
let s_back = c_to_rust_owned(c_str);
println!("转换回来的 String: {}", s_back);

B. 获取引用 (从 &CStr 获取 &str)

如果你只需要读取 CString 的内容，可以获取它的引用 &CStr，然后转换为 Rust 的字符串切片 &str。

使用 .as_c_str() 获得 &CStr 引用。
使用 .to_str() 获得 &str 引用（同样需要处理 UTF-8 错误）。

use std::ffi::{CStr, CString};fn c_ref_to_rust_ref(c_str: &CStr) -> &str {// 转换为 &str 引用，需要处理 UTF-8 错误let rust_slice = c_str.to_str().expect("CStr 不是有效的 UTF-8");rust_slice
}// 完整示例：
let c_str = CString::new("Example").unwrap();// 获取一个临时的 &CStr 引用
let rust_slice = c_str.as_c_str(); 
let final_str = c_ref_to_rust_ref(rust_slice);println!("引用方式转换: {}", final_str);

总结表格

方向	使用方法	返回类型（需错误处理）	注意事项
`String` -> `CString`	`CString::new(s)`	`Result<CString, NulError>`	`String` 中不能有 `\0`
`CString` -> `String`	`c_str.into_string()`	`Result<String, IntoStringError>`	字节必须是 UTF-8
`&CStr` -> `&str`	`c_str.to_str()`	`Result<&str, Utf8Error>`	字节必须是 UTF-8