格式化输出

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

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

这些宏都以相同的做法解析(parse)文本。另外有个优点是格式化的正确性会在编译时检查。

  1. fn main() {
  2. // 通常情况下,`{}` 会被任意变量内容所替换。
  3. // 变量内容会转化成字符串。
  4. println!("{} days", 31);
  5. // 不加后缀的话,31 就自动成为 i32 类型。
  6. // 你可以添加后缀来改变 31 的类型。
  7. // 用变量替换字符串有多种写法。
  8. // 比如可以使用位置参数。
  9. println!("{0}, this is {1}. {1}, this is {0}", "Alice", "Bob");
  10. // 可以使用命名参数。
  11. println!("{subject} {verb} {object}",
  12. object="the lazy dog",
  13. subject="the quick brown fox",
  14. verb="jumps over");
  15. // 可以在 `:` 后面指定特殊的格式。
  16. println!("{} of {:b} people know binary, the other half don't", 1, 2);
  17. // 你可以按指定宽度来右对齐文本。
  18. // 下面语句输出 " 1",5 个空格后面连着 1。
  19. println!("{number:>width$}", number=1, width=6);
  20. // 你可以在数字左边补 0。下面语句输出 "000001"。
  21. println!("{number:>0width$}", number=1, width=6);
  22. // println! 会检查使用到的参数数量是否正确。
  23. println!("My name is {0}, {1} {0}", "Bond");
  24. // 改正 ^ 补上漏掉的参数:"James"
  25. // 创建一个包含单个 `i32` 的结构体(structure)。命名为 `Structure`。
  26. #[allow(dead_code)]
  27. struct Structure(i32);
  28. // 但是像结构体这样的自定义类型需要更复杂的方式来处理。
  29. // 下面语句无法运行。
  30. println!("This struct `{}` won't print...", Structure(3));
  31. // 改正 ^ 注释掉此行。
  32. }

std::fmt 包含多种 traits(trait 有 “特征,特性” 等意思) 来控制文字显示,其中重要的两种 trait 的基本形式如下:

  • 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