Rust / 系统课时

借用函数参数

借用函数参数

按值传入 String 会把所有权移动进函数,调用结束后调用方通常不能再使用原变量。把参数改成引用后,函数只临时访问数据而不取得所有权,因此调用方可以在借用结束后继续读取或修改原值。

学习目标

  • 把按值参数改写为共享引用或可变引用
  • 判断函数调用期间谁仍然拥有数据
  • 正确选择 &T、&mut T 与更通用的切片引用

从按值传参改成借用

若函数签名是 fn consume(text: String),调用 consume(message) 会移动 message 的所有权。函数结束时,参数 text 被销毁,调用方也失去了原来的变量。

当函数只需要读取数据时,可改为 &String;当函数需要修改但不接管数据时,可改为 &mut String。引用本身只是临时访问权,底层 String 的所有者仍然是调用方。

一个可运行示例

下面的程序先用共享借用读取字符串长度,再用可变借用追加内容。两次函数调用都不会取得 message 的所有权,所以主函数可以继续使用它。

rust
fn print_len(text: &String) {
    // 共享引用只读取数据,不取得 String 的所有权。
    println!("len = {}", text.len());
}

fn append_suffix(text: &mut String) {
    // 可变引用允许原地修改,但所有者仍然是调用方。
    text.push_str(" world");
}

fn main() {
    let mut message = String::from("hello");

    print_len(&message);
    println!("after shared borrow: {message}");

    append_suffix(&mut message);
    println!("after mutable borrow: {message}");
}

预期输出

text
len = 5
after shared borrow: hello
after mutable borrow: hello world

第一次调用创建 &message,函数只能读取;这次借用在最后一次使用后结束,因此下一行仍可读取 message。第二次调用创建 &mut message,函数可以修改原对象,但调用返回后可变借用结束,所有权仍在 main 中。

共享借用与可变借用的边界

共享引用 &T 允许多个只读借用并存,因为这些借用不会修改值。可变引用 &mut T 强调独占访问:同一时刻不能再有其他仍在使用的共享或可变借用指向同一数据。

这条规则不是为了限制函数拆分,而是为了在编译期阻止数据竞争和悬垂访问。实际代码中,借用通常只持续到引用最后一次被使用的位置,而不一定机械地延续到整个花括号结束。

参数类型如何选

若函数确实依赖 String 本身的能力,可以接收 &String 或 &mut String。如果函数只需要读取字符串内容,通常更推荐把参数写成 &str,这样既能接收 String 的借用,也能接收字符串字面量和其他字符串切片。

选择参数类型时先问“函数是否需要拥有这个值”。不需要拥有就优先借用;只读用共享引用,需要原地修改则用可变引用。这样既避免不必要的移动和克隆,也让调用方在函数返回后继续掌握原数据。

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

目录与阅读设置

记录一个想法

借用函数参数

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

登录哪都通