格式化

我们已经看到，格式化的方式是通过格式字符串来指定的：

  • format!("{}", foo) -> "3735928559"
  • format!("0x{:X}", foo) -> "0xDEADBEEF"
  • format!("0o{:o}", foo) -> "0o33653337357"

根据使用的参数类型是 X、o 还是未指定，同样的变量（foo）能够格式化 成不同的形式。

这个格式化的功能是通过 trait 实现的，每种参数类型都对应一种 trait。最常见的格式 化 trait 就是 Display，它可以处理参数类型为未指定的情况，比如 {}。

1. use std::fmt::{self, Formatter, Display};

3. struct City {
4. name: &'static str,
5. // 纬度
6. lat: f32,
7. // 经度
8. lon: f32,
9. }

11. impl Display for City {
12. // `f` 是一个缓冲区（buffer），此方法必须将格式化后的字符串写入其中
13. fn fmt(&self, f: &mut Formatter) -> fmt::Result {
14. let lat_c = if self.lat >= 0.0 { 'N' } else { 'S' };
15. let lon_c = if self.lon >= 0.0 { 'E' } else { 'W' };

17. // `write!` 和 `format!` 类似，但它会将格式化后的字符串写入
18. // 一个缓冲区（即第一个参数f）中。
19. write!(f, "{}: {:.3}°{} {:.3}°{}",
20. self.name, self.lat.abs(), lat_c, self.lon.abs(), lon_c)
21. }
22. }

24. #[derive(Debug)]
25. struct Color {
26. red: u8,
27. green: u8,
28. blue: u8,
29. }

31. fn main() {
32. for city in [
33. City { name: "Dublin", lat: 53.347778, lon: -6.259722 },
34. City { name: "Oslo", lat: 59.95, lon: 10.75 },
35. City { name: "Vancouver", lat: 49.25, lon: -123.1 },
36. ].iter() {
37. println!("{}", *city);
38. }
39. for color in [
40. Color { red: 128, green: 255, blue: 90 },
41. Color { red: 0, green: 3, blue: 254 },
42. Color { red: 0, green: 0, blue: 0 },
43. ].iter() {
44. // 在添加了针对 fmt::Display 的实现后，请改用 {} 检验效果。
45. println!("{:?}", *color)
46. }
47. }

在 fmt::fmt 文档中可以查看格式化 traits 一览表和它们的参 数类型。

动手试一试

为上面的 Color 结构体实现 fmt::Display，应得到如下的输出结果：

1. RGB (128, 255, 90) 0x80FF5A
2. RGB (0, 3, 254) 0x0003FE
3. RGB (0, 0, 0) 0x000000

如果感到疑惑，可看下面两条提示：

参见：

std::fmt