Rust / 系统课时
选择方法接收者
选择方法接收者
Rust 方法的接收者决定方法是在借用实例、可变借用实例,还是直接取得实例所有权。选对 &self、&mut self 与 self,可以让接口准确表达行为,同时避免不必要的移动和借用冲突。
学习目标
- 区分
&self、&mut self与self对所有权的影响 - 根据方法是否读取、修改或消费实例选择接收者
- 判断方法调用后原实例是否还能继续使用
三种接收者改变什么
方法接收者本质上是一个特殊的第一个参数。&self 相当于共享借用当前实例,&mut self 相当于独占的可变借用,而 self 会把实例按值传入方法。
| 接收者 | 方法获得什么 | 能否直接修改普通字段 | 调用后实例是否仍存在 |
|---|---|---|---|
&self |
&Self |
否 | 是 |
&mut self |
&mut Self |
是 | 是 |
self |
Self |
可以拥有并移动字段 | 通常否 |
&self 最适合查询状态或计算结果;&mut self 用于在原实例上修改状态;self 则适合转换、关闭、构建完成等调用后不再需要原值的操作。
用一个类型观察三种行为
下面的 Article 同时提供只读、修改和消费三类方法。调用者必须把变量声明为可变,才能调用需要 &mut self 的方法。
struct Article {
title: String,
reads: u32,
}
impl Article {
fn title(&self) -> &str {
&self.title
}
fn read(&mut self) {
// 可变借用期间可以修改当前实例的普通字段。
self.reads += 1;
}
fn into_title(self) -> String {
// self 已归方法所有,因此可以直接移出其中的 String。
self.title
}
}
fn main() {
let mut article = Article {
title: String::from("Rust 所有权"),
reads: 0,
};
println!("title={}", article.title());
article.read();
println!("reads={}", article.reads);
let title = article.into_title();
println!("moved={title}");
}预期输出
title=Rust 所有权
reads=1
moved=Rust 所有权前两次调用只是借用了 article,借用结束后仍可继续访问它。into_title 接收 self,调用时 article 的所有权被移动进方法,因此此后不能再使用 article。
根据行为选择接收者
如果方法只需要观察实例,优先使用 &self。这样调用者保留所有权,而且同一时刻可以存在多个共享借用,很适合 getter、格式化和只读计算。
如果方法必须在原对象上改变状态,使用 &mut self。调用期间 Rust 会要求该实例没有其他冲突借用,因此方法能够安全地修改字段。调用者持有的是普通局部变量时,通常还需要通过 let mut 允许可变借用。
如果方法的语义就是消费当前值,使用 self。常见场景包括把包装类型转换成内部值、构建器的最终转换,或者调用后对象已经没有继续使用的意义。按值接收还能直接移动非 Copy 字段,而不必克隆它们。
不要用接收者掩盖真实语义
仅仅为了修改局部计算过程,不需要把方法改成 &mut self;只有要改变实例本身时才需要可变接收者。同样,如果方法完成后对象仍然有合理用途,就不应随意使用 self,否则调用者可能被迫克隆整个值。
还有一种特殊情况是内部可变性:即使方法使用 &self,Cell、RefCell、锁等类型仍可能允许其内部状态变化。这是这些类型提供的额外机制,不代表 &self 本身拥有普通字段的可变权限。
选择接收者时可以直接问三个问题:只读当前值就选 &self,要修改同一个实例就选 &mut self,调用完成后应当交出或销毁原值就选 self。接收者因此不仅影响编译器的借用检查,也构成了方法 API 的所有权契约。