方法

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

  1. struct Point {
  2.     x: f64,
  3.     y: f64,
  4. }
  6. // 实现的代码块，`Point` 的所有方法都在这里给出
  7. impl Point {
  8.     // 这是一个静态方法（static method）
  9.     // 静态方法不需要被实例调用
  10.     // 这类方法一般用作构造器（constructor）
  11.     fn origin() -> Point {
  12.         Point { x: 0.0, y: 0.0 }
  13.     }
  15.     // 另外一个静态方法，需要两个参数：
  16.     fn new(x: f64, y: f64) -> Point {
  17.         Point { x: x, y: y }
  18.     }
  19. }
  21. struct Rectangle {
  22.     p1: Point,
  23.     p2: Point,
  24. }
  26. impl Rectangle {
  27.     // 这是一个实例方法（instance method）
  28.     // `&self` 是 `self: &Self` 的语法糖（sugar），其中 `Self` 是方法调用者的
  29.     // 类型。在这个例子中 `Self` = `Rectangle`
  30.     fn area(&self) -> f64 {
  31.         // `self` 通过点运算符来访问结构体字段
  32.         let Point { x: x1, y: y1 } = self.p1;
  33.         let Point { x: x2, y: y2 } = self.p2;
  35.         // `abs` 是一个 `f64` 类型的方法，返回调用者的绝对值
  36.         ((x1 - x2) * (y1 - y2)).abs()
  37.     }
  39.     fn perimeter(&self) -> f64 {
  40.         let Point { x: x1, y: y1 } = self.p1;
  41.         let Point { x: x2, y: y2 } = self.p2;
  43.         2.0 * ((x1 - x2).abs() + (y1 - y2).abs())
  44.     }
  46.     // 这个方法要求调用者是可变的
  47.     // `&mut self` 为 `self: &mut Self` 的语法糖
  48.     fn translate(&mut self, x: f64, y: f64) {
  49.         self.p1.x += x;
  50.         self.p2.x += x;
  52.         self.p1.y += y;
  53.         self.p2.y += y;
  54.     }
  55. }
  57. // `Pair` 拥有资源：两个堆分配的整型
  58. struct Pair(Box<i32>, Box<i32>);
  60. impl Pair {
  61.     // 这个方法会 “消耗” 调用者的资源
  62.     // `self` 为 `self: Self` 的语法糖
  63.     fn destroy(self) {
  64.         // 解构 `self`
  65.         let Pair(first, second) = self;
  67.         println!("Destroying Pair({}, {})", first, second);
  69.         // `first` 和 `second` 离开作用域后释放
  70.     }
  71. }
  73. fn main() {
  74.     let rectangle = Rectangle {
  75.         // 静态方法使用双冒号调用
  76.         p1: Point::origin(),
  77.         p2: Point::new(3.0, 4.0),
  78.     };
  80.     // 实例方法通过点运算符来调用
  81.     // 注意第一个参数 `&self` 是隐式传递的，亦即：
  82.     // `rectangle.perimeter()` === `Rectangle::perimeter(&rectangle)`
  83.     println!("Rectangle perimeter: {}", rectangle.perimeter());
  84.     println!("Rectangle area: {}", rectangle.area());
  86.     let mut square = Rectangle {
  87.         p1: Point::origin(),
  88.         p2: Point::new(1.0, 1.0),
  89.     };
  91.     // 报错！ `rectangle` 是不可变的，但这方法需要一个可变对象
  92.     //rectangle.translate(1.0, 0.0);
  93.     // 试一试 ^ 去掉此行的注释
  95.     // 正常运行！可变对象可以调用可变方法
  96.     square.translate(1.0, 1.0);
  98.     let pair = Pair(Box::new(1), Box::new(2));
  100.     pair.destroy();
  102.     // 报错！前面的 `destroy` 调用 “消耗了” `pair`
  103.     //pair.destroy();
  104.     // 试一试 ^ 将此行注释去掉
  105. }