01-方法

Thu, 20 Aug 2026 21:20:00 +0800

译文 · 基于 Rust By Example

原文链接: https://doc.rust-lang.org/stable/rust-by-example/fn/methods.html

方法

方法（method）是依附于对象的函数。这些方法通过关键字 self 来访问对象中的数据和其他。方法在 impl 代码块中定义。

 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105


struct Point {
 x: f64,
 y: f64,
}

// 实现的代码块，`Point` 的所有方法都在这里给出
impl Point {
 // 这是一个静态方法（static method）
 // 静态方法不需要被实例调用
 // 这类方法一般用作构造器（constructor）
 fn origin() -> Point {
 Point { x: 0.0, y: 0.0 }
 }

 // 另外一个静态方法，需要两个参数：
 fn new(x: f64, y: f64) -> Point {
 Point { x: x, y: y }
 }
}

struct Rectangle {
 p1: Point,
 p2: Point,
}

impl Rectangle {
 // 这是一个实例方法（instance method）
 // `&self` 是 `self: &Self` 的语法糖（sugar），其中 `Self` 是方法调用者的
 // 类型。在这个例子中 `Self` = `Rectangle`
 fn area(&self) -> f64 {
 // `self` 通过点运算符来访问结构体字段
 let Point { x: x1, y: y1 } = self.p1;
 let Point { x: x2, y: y2 } = self.p2;

 // `abs` 是一个 `f64` 类型的方法，返回调用者的绝对值
 ((x1 - x2) * (y1 - y2)).abs()
 }

 fn perimeter(&self) -> f64 {
 let Point { x: x1, y: y1 } = self.p1;
 let Point { x: x2, y: y2 } = self.p2;

 2.0 * ((x1 - x2).abs() + (y1 - y2).abs())
 }

 // 这个方法要求调用者是可变的
 // `&mut self` 为 `self: &mut Self` 的语法糖
 fn translate(&mut self, x: f64, y: f64) {
 self.p1.x += x;
 self.p2.x += x;

 self.p1.y += y;
 self.p2.y += y;
 }
}

// `Pair` 拥有资源：两个堆分配的整型
struct Pair(Box<i32>, Box<i32>);

impl Pair {
 // 这个方法会 “消耗” 调用者的资源
 // `self` 为 `self: Self` 的语法糖
 fn destroy(self) {
 // 解构 `self`
 let Pair(first, second) = self;

 println!("Destroying Pair({}, {})", first, second);

 // `first` 和 `second` 离开作用域后释放
 }
}

fn main() {
 let rectangle = Rectangle {
 // 静态方法使用双冒号调用
 p1: Point::origin(),
 p2: Point::new(3.0, 4.0),
 };

 // 实例方法通过点运算符来调用
 // 注意第一个参数 `&self` 是隐式传递的，亦即：
 // `rectangle.perimeter()` === `Rectangle::perimeter(&rectangle)`
 println!("Rectangle perimeter: {}", rectangle.perimeter());
 println!("Rectangle area: {}", rectangle.area());

 let mut square = Rectangle {
 p1: Point::origin(),
 p2: Point::new(1.0, 1.0),
 };

 // 报错！ `rectangle` 是不可变的，但这方法需要一个可变对象
 //rectangle.translate(1.0, 0.0);
 // 试一试 ^ 去掉此行的注释

 // 正常运行！可变对象可以调用可变方法
 square.translate(1.0, 1.0);

 let pair = Pair(Box::new(1), Box::new(2));

 pair.destroy();

 // 报错！前面的 `destroy` 调用 “消耗了” `pair`
 //pair.destroy();
 // 试一试 ^ 将此行注释去掉
}

03-高阶函数

Thu, 20 Aug 2026 21:20:00 +0800

译文 · 基于 Rust By Example

原文链接: https://doc.rust-lang.org/stable/rust-by-example/fn/hof.html

高阶函数

Rust 提供了高阶函数（Higher Order Function, HOF），指那些输入一个或多个函数，并且/或者产生一个更有用的函数的函数。HOF 和惰性迭代器（lazy iterator）给 Rust 带来了函数式（functional）编程的风格。

04-发散函数

Thu, 20 Aug 2026 21:20:00 +0800

译文 · 基于 Rust By Example

原文链接: https://doc.rust-lang.org/stable/rust-by-example/fn/diverging.html

发散函数

发散函数（diverging function）绝不会返回。它们使用 ! 标记，这是一个空类型。

1
2
3


fn foo() -> ! {
 panic!("This call never returns.");
}

和所有其他类型相反，这个类型无法实例化，因为此类型可能具有的所有可能值的集合为空。注意，它与 () 类型不同，后者只有一个可能的值。

第9章 函数 on 编程那些事儿

01-方法

方法

03-高阶函数

高阶函数

04-发散函数

发散函数

第9章函数 on 编程那些事儿