格式化输出

打印操作由std::fmt里面所定义的一系列来处理,其中包括:

  • format!:将格式化文本写到字符串(String)。(译注: 字符串是返回值不是参数。)
  • print!:与 format!类似,但将文本输出到控制台。
  • println!: 与 print!类似,但输出结果追加一个换行符。

所有的解析文本都以相同的方式进行。另外一点是格式化的正确性在编译时检查。

fn main() {
    // 通常情况下, `{}` 会被任意变量内容所替换。
    // 值内容会转化成字符串。
    println!("{} days", 31);

    // 不加后缀的话,31自动成为 I32 类型。
    // 你可以添加后缀来改变 31 的原来类型。

    // 下面有多种可选形式。
    // 可以使用的位置参数。
    println!("{0}, this is {1}. {1}, this is {0}", "Alice", "Bob");

    // 可以使用赋值语句。
    println!("{subject} {verb} {object}",
             object="the lazy dog",
             subject="the quick brown fox",
             verb="jumps over");

    // 特殊的格式实现可以在后面加上 `:` 符号。
    println!("{} of {:b} people know binary, the other half don't", 1, 2);

    // 你可以按指定宽度来右对齐文本。
    // 下面语句输出"     1",5个空格后面连着1。
    println!("{number:>width$}", number=1, width=6);

    // 你可以对数字左边位数上补0。下面语句输出"000001"。
    println!("{number:>0width$}", number=1, width=6);

    // println! 会检查使用到的参数数量是否正确。
    println!("My name is {0}, {1} {0}", "Bond");
    // 改正 ^ 补上漏掉的参数: "James"

    // 创建一个包含` I32 `类型结构体(structure)。命名为 `Structure`。
    #[allow(dead_code)]
    struct Structure(i32);

    // 但是像结构体这样自定义类型需要更复杂的方式来处理。
    // 下面语句无法运行。
    println!("This struct `{}` won't print...", Structure(3));
    // 改正 ^ 注释掉此行。
}

std::fmt包含多种traits(traits翻译成中文有“特征,特性”等意思)来控制文字显示。这里面有两个重要的基本格式类型如下:

  • fmt::Debug:使用 {:?} 作标记。格式化文本以便调试。
  • fmt::Display:使用 {} 作标记。以优雅和友好的方式来格式文本。

在本书中我们使用fmt::Display,因为标准库提供了这些类型的实现。若要打印自定义类型的文本,需要更多的步骤。

动手试一试

  • 改正上面代码中的两个错误(见 改正),使得运行不会报错。

  • 添加一个 println! 宏来打印:Pi is roughly 3.142(Pi约等于3.142),通过控制有效数字得到显示的结果。为了达到练习目的,使用 let pi = 3.141592 作为 Pi 的近似值(提示:设置小数位的显示格式可以参考文档std::fmt)。

参见:

std::fmt, macros, structtraits