方法调用表达式

^语法
方法调用表达式 :
   表达式 . 路径表达式片段 (调用参数组^? )

方法调用 由一个表达式 (即 接收者 ) 加上一个点 ( . ) 、一个表达式路径段、和括号括起来的表达式列表组成。 方法调用会解析到特定 trait 上关联的方法，如果左侧表达式是确切的 self 类型，则静态调用方法，如果左侧表达式是一个间接的 trait 对象，则动态调用。

#![allow(unused)]
fn main() {
let pi: Result<f32, _> = "3.14".parse();
let log_pi = pi.unwrap_or(1.0).log(2.72);
assert!(1.14 < log_pi && log_pi < 1.15)
}

在查找方法调用时，为了调用方法，接收者可能会自动解引用或借用。与其他函数相比，这需要更复杂的查找过程，因为可能有更多可以调用的方法。 因而将使用以下过程:

第一步是构建候选接收者类型列表。通过重复 解引用 接收者表达式的类型，将遇到的每种类型添加到该列表，然后尝试 不确定大小的强制转换 ，如果成功，则转换结果类型也添加到列表。然后，对于每个候选项 T 之前添加 &T 和 &mut T 。

例如，如果接收者的类型为 Box<[i32;2]> ，则候选类型将是 Box<[i32;2]> 、 &Box<[i32;2]> 、 &mut Box<[i32;2]> 、 [i32;2] (通过解引用) 、 &[i32;2] 、&mut [i32;2] 、 [i32] (通过不可缩放强制转换) 、 &[i32] 和 &mut [i32] 。

然后，对于每个候选类型 T ，在以下位置搜索具有该类型接收者 可见 的方法:

1. T 的内部方法 (直接在 T 上实现的方法)。
2. 由 T 实现的 可见 trait 提供的任何方法。如果 T 是类型参数，则首先查找 T 的 trait 约束提供的方法，然后查找所有剩余的作用域内方法。

注意: 查找是按顺序对每种类型进行的，这可能偶尔会导致令人惊讶的结果。 下面的代码将打印 "In trait impl!" ，因为 &self 方法首先被查找，在找到结构体的 &mut self 方法之前就找到了 trait 方法。

struct Foo {}

trait Bar {
  fn bar(&self);
}

impl Foo {
  fn bar(&mut self) {
    println!("In struct impl!")
  }
}

impl Bar for Foo {
  fn bar(&self) {
    println!("In trait impl!")
  }
}

fn main() {
  let mut f = Foo{};
  f.bar();
}

如果这个过程导致有多个可能的候选方法，那么就会出现错误，接收者必须被转换为适当的接收者类型才能调用该方法。

这个过程不考虑接收者的可变性或生命周期，也不考虑方法是否是 unsafe 。一旦找到一个方法，如果出于其中一个或多个原因无法调用，则调用结果就是编译器错误。

如果在某个步骤，其中有多个可能的方法，比如在需要考虑调用泛型方法还是 trait 时，就是编译器错误。 这些情况需要使用 消除歧义的函数调用语法 来调用方法和函数。

版本差异: 在 2021 版本之前，寻找可见方法时，如果候选接收者类型是 数组类型 ，则忽略标准库 IntoIterator trait 提供的方法。

此语法的版次由表示方法名称的 token 确定。

这种特殊情况可能会在将来被删除。