Rust / 系统课时
在 String 与 str 间借用
在 String 与 str 间借用
Rust 文本接口最常见的选择不是在 String 和 &String 之间二选一,而是先判断函数是否需要拥有文本。只读场景通常接收 &str,这样既能读取 String 的内容,也能直接接受字符串字面量和字符串切片。
学习目标
- 区分
String、&String与&str的所有权和借用语义。 - 使用
&str设计只读文本接口,并让String通过借用参与调用。 - 理解切片的有效范围与 UTF-8 边界限制。
三种常见写法的含义
String 拥有一段可增长的 UTF-8 字节缓冲区,变量离开作用域时负责释放内存。&String 是对某个 String 对象的共享借用,能访问 String 的能力,但把参数写成它通常会把接口限制得过窄。
str 是动态大小类型,日常代码通常通过 &str 使用它。&str 表示一段有效 UTF-8 文本的借用视图,它既可以指向 String 的全部或部分内容,也可以指向字符串字面量等其他文本存储。
| 类型 | 是否拥有文本 | 常见用途 |
|---|---|---|
String |
是 | 需要保存、转移或增长文本 |
&String |
否 | 必须明确借用一个 String 对象的少数场景 |
&str |
否 | 只读参数、字符串字面量、子串视图 |
只读 API 优先接收 &str,核心原因是它表达的约束更少:调用者只需要提供一段字符串切片,而不必拥有某种特定容器。
让只读接口接收 str 切片
下面的 describe 只读取文本,因此参数使用 &str。同一个函数可以接收 String 的借用、&String、子切片和字符串字面量。
fn describe(text: &str) {
println!("{text} / {} bytes", text.len());
}
fn main() {
let owned = String::from("Rust ownership");
let borrowed_string: &String = &owned;
let slice: &str = &owned[0..4];
let literal: &str = "borrow";
// &String 可以通过解引用强制转换匹配 &str。
describe(&owned);
describe(borrowed_string);
describe(slice);
describe(literal);
// 前面的调用都只是借用,owned 的所有权仍在 main 中。
println!("still owned: {owned}");
}预期输出
Rust ownership / 14 bytes
Rust ownership / 14 bytes
Rust / 4 bytes
borrow / 6 bytes
still owned: Rust ownership这里 describe(&owned) 先显式创建对 String 的借用,再由解引用强制转换得到 &str;borrowed_string 已经是 &String,也能转换为 &str。这些调用都不会转移 owned 的所有权。
String 如何借用成 str
从 String 得到 &str 有两种常用写法:&text 依赖解引用强制转换,text.as_str() 则显式返回字符串切片。作为函数实参时,两者都很常见;若读者需要清楚看到类型边界,as_str() 往往更直观。
反过来,&str 不能无条件变成 &String,因为它可能来自字符串字面量或某个 String 的局部切片,根本不存在对应的完整 String 对象。也正因为如此,要求 &String 的只读函数通常比要求 &str 更难复用。
切片不能比原数据活得更久
&str 只是借用视图,它的生命周期不能超过底层数据。若切片来自局部 String,就不能在 String 被释放后继续使用该切片;编译器会在这种情况下拒绝代码,从而避免悬垂引用。
还要注意字符串切片的索引是字节偏移,切分位置必须落在 UTF-8 字符边界上。像 &text[0..4] 对纯 ASCII 示例没有问题,但对中文或其他多字节字符不能凭“第几个字符”直接计算字节下标。只读文本接口优先使用 &str,再配合借用检查和合法切片边界,就能在不复制文本的前提下保持接口灵活且安全。