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、子切片和字符串字面量。

rust
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}");
}

预期输出

text
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,再配合借用检查和合法切片边界,就能在不复制文本的前提下保持接口灵活且安全。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

在 String 与 str 间借用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通