Rust / 系统课时

实现方法

实现方法

impl 块可以把行为直接绑定到结构体类型上,让数据与操作保持一致。本课将通过一个可运行示例实现实例方法和关联函数,并说明 self、&self、&mut self 的选择原则。

学习目标

  • 能使用 impl 定义实例方法和关联函数
  • 能根据是否读取、修改或取得所有权选择接收者
  • 能通过 Type::function 和实例点语法调用对应函数

在 impl 中定义行为

方法的第一个参数必须是某种形式的 self,它代表当前实例。关联函数没有 self 参数,通常用于构造实例,因此常命名为 new。

rust
#[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:?}");
}

预期输出:

text
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 会取得实例所有权,方法结束后实例通常被消耗。它适合把对象转换为另一种类型、提取内部数据,或明确表示调用后原对象不再可用。

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

预期输出:

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 表示当前实现类型,适合构造函数参数和返回值,能减少重复类型名

下一课预告

下一课将进入枚举,学习如何用一个类型表达多个互斥变体,并为不同变体携带不同的数据。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现方法

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

登录哪都通