Rust / 系统课时
实现方法
实现方法
impl 块可以把行为直接绑定到结构体类型上,让数据与操作保持一致。本课将通过一个可运行示例实现实例方法和关联函数,并说明 self、&self、&mut self 的选择原则。
学习目标
- 能使用
impl定义实例方法和关联函数 - 能根据是否读取、修改或取得所有权选择接收者
- 能通过
Type::function和实例点语法调用对应函数
在 impl 中定义行为
方法的第一个参数必须是某种形式的 self,它代表当前实例。关联函数没有 self 参数,通常用于构造实例,因此常命名为 new。
#[derive(Debug)]
struct Rectangle {
width: u32,
height: u32,
}
impl Rectangle {
// 关联函数不接收 self,通常承担构造职责
fn new(width: u32, height: u32) -> Self {
Self { width, height }
}
// 只读计算借用实例,不取得所有权
fn area(&self) -> u32 {
self.width * self.height
}
fn can_hold(&self, other: &Self) -> bool {
self.width > other.width && self.height > other.height
}
// 修改字段需要可变借用
fn scale(&mut self, factor: u32) {
self.width *= factor;
self.height *= factor;
}
}
fn main() {
let mut outer = Rectangle::new(30, 20);
let inner = Rectangle::new(10, 5);
println!("area = {}", outer.area());
println!("can hold = {}", outer.can_hold(&inner));
outer.scale(2);
println!("scaled = {outer:?}");
}预期输出:
area = 600
can hold = true
scaled = Rectangle { width: 60, height: 40 }Rectangle::new 是关联函数,通过类型名调用。area、can_hold 和 scale 是实例方法,通过点语法调用。返回类型中的 Self 等价于当前 impl 对应的类型,即 Rectangle。
选择 self 接收方式
&self 只借用实例,适合读取字段或计算结果,不会取得所有权。绝大多数查询方法都应优先使用这种形式。
&mut self 可修改实例,因此调用者必须持有可变实例。它适合更新状态、追加内容或调整配置。
self 会取得实例所有权,方法结束后实例通常被消耗。它适合把对象转换为另一种类型、提取内部数据,或明确表示调用后原对象不再可用。
struct Message {
text: String,
}
impl Message {
// into_ 前缀通常表示方法会消耗当前实例
fn into_text(self) -> String {
self.text
}
}
fn main() {
let message = Message {
text: String::from("hello"),
};
// 调用后 message 已被移动,不能再次访问
let text = message.into_text();
println!("{text}");
}预期输出:
hello调用 into_text 后,message 已被移动,不能再次使用。方法名使用 into_ 前缀,也能向调用者提示该操作会取得所有权并完成转换。
调用规则与组织方式
调用 value.method() 时,Rust 会根据方法签名自动补充借用或解引用。例如,方法需要 &self 时,写 rectangle.area() 即可,不必手动写成 (&rectangle).area()。
自动调整不会绕过借用规则:当一个 &mut self 方法执行时,同一实例不能同时存在其他有效借用。只有带 self 参数的函数才能使用实例点语法;没有 self 的关联函数应通过 Type::function(...) 调用。
同一个类型可以拆分为多个 impl 块。小型类型通常集中定义更易阅读;当构造、查询、状态修改或 trait 实现较多时,可按职责拆分。关联函数常用 new、from_*、with_*,取得所有权的转换方法常用 into_*,清晰命名能让调用后果更容易预测。
本课总结
- 实例方法必须以
self、&self或&mut self作为第一个参数,关联函数则不接收self - 只读操作优先使用
&self,修改状态使用&mut self,消耗实例时使用self Self表示当前实现类型,适合构造函数参数和返回值,能减少重复类型名
下一课预告
下一课将进入枚举,学习如何用一个类型表达多个互斥变体,并为不同变体携带不同的数据。