Rust / 系统课时
标注函数生命周期
标注函数生命周期
当函数接收多个引用并返回其中一个时,编译器必须知道返回值与哪些输入引用相关。本文用一个可运行的 longest 函数说明生命周期参数的写法、约束含义,以及何时可以依赖生命周期省略规则。
学习目标
- 为接受并返回引用的函数声明生命周期参数。
- 正确解释返回引用与多个输入引用之间的有效期约束。
- 判断哪些函数签名可以省略显式生命周期标注。
函数签名必须表达引用关系
如果函数只接收引用但不返回引用,通常不需要手写生命周期。真正需要表达关系的典型场景,是返回值本身也是引用,而它可能来自一个或多个输入引用。
当编译器无法仅靠省略规则确定“返回引用依赖哪个输入”时,函数签名就必须把这种关系写出来。生命周期参数写在函数名后的尖括号中,名称通常从 'a 开始。
标注输入与返回值
下面的 longest 返回两个字符串切片中较长的一个,因此返回值可能来自 x,也可能来自 y。三个位置都使用 'a,表示返回引用不能比这两个输入引用共同可用的区间更长。
fn longest<'a>(x: &'a str, y: &'a str) -> &'a str {
if x.len() >= y.len() {
x
} else {
y
}
}
fn main() {
let outer = String::from("rust lifetimes");
{
let inner = String::from("borrow");
let result = longest(outer.as_str(), inner.as_str());
println!("{result}");
}
}预期输出:
rust lifetimesouter 比 inner 活得更久,但调用 longest 时,返回值的可用范围会受较短的那个输入约束。示例把 result 的使用放在内层代码块中,因此无论函数最终返回 x 还是 y,引用都仍然有效。
'a 表示约束而不是统一寿命
'a 并不要求 x 和 y 在现实中拥有完全相同的寿命,也不会修改它们各自的存活时间。编译器会为一次具体调用寻找一个同时满足两者的有效范围,并要求返回引用的使用不超出这个范围。
因此,如果把示例中的 println!("{result}") 移到内层代码块之外,程序会被拒绝。虽然这一次运行中 longest 实际返回的是 outer,但函数签名允许它返回 inner,编译器必须依据签名保证所有合法执行路径都安全,而不能依赖字符串长度的运行时结果。
只标注真正相关的输入
生命周期参数应表达真实依赖,不要为了“保险”把所有引用都绑到同一个生命周期。如果一个函数始终返回第一个参数,那么可以让返回值只受第一个参数约束,例如 fn first<'a>(x: &'a str, _y: &str) -> &'a str。这样第二个参数即使较早失效,也不会无谓地缩短返回引用的可用范围。
这种写法的核心是:返回引用来自谁,就让签名准确描述它依赖谁。生命周期标注过宽不会提升安全性,反而可能让本来安全的调用被编译器拒绝。
什么时候可以省略标注
Rust 对常见函数签名提供生命周期省略规则。最常用的一条是:只有一个输入引用时,编译器可以把它的生命周期赋给所有省略了生命周期的输出引用,所以 fn first_word(s: &str) -> &str 不需要显式写 'a。
方法还存在与 &self、&mut self 相关的省略规则。相反,当普通函数有多个输入引用,又返回引用且无法唯一确定来源时,就应显式标注生命周期关系。此时标注的目的不是“让编译器闭嘴”,而是把函数对调用者承诺的引用来源写进类型签名。