格式化

我们可以看到格式化就是通过格式字符串得到特定格式：

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

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

这个格式化的功能是通过 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