文档章节
格式化输出函数
使用这些函数在模板中输出字符串,或向终端输出消息。
这一页解决什么问题
这一章收录两类函数:一类返回字符串,用来在模板里拼装内容(print、printf、println);另一类写构建日志,用来在构建期报告问题(warnf、warnidf、errorf、erroridf)。上游这些页原来只有签名和一两行说明,本站为每页补上了「什么时候用 / 什么时候别用」「可直接粘贴的实测示例」与「返回值边界」。
读完本章你应该能够
- 分清三个返回字符串的函数:
print不加空格、println加空格并补换行、printf用格式动词控制输出; - 分清四个日志函数的后果:
warnf/warnidf不影响构建,errorf/erroridf让构建失败;带id的两个可以用ignoreLogs抑制; - 知道格式动词与参数类型不符时不会报错,而是把
%!d(string=abc)这样的文本直接写进产物(实测),并据此排查页面上的%!片段。
建议阅读顺序
- 返回值函数:fmt.Print、fmt.Println、fmt.Printf;
- 日志函数:fmt.Warnf、fmt.Warnidf、fmt.Errorf、fmt.Erroridf;
- 深入格式动词:Go 官方的
fmt包文档(上游在这些页面里给出的就是它的链接)。
如果你只关心一件事:让构建失败用 errorf,只想提醒用 warnf,想让使用者能关掉就用带 id 的版本。
本章内容
- fmt.Errorf 从模板记录一条 ERROR 日志。 (今天)
- fmt.Erroridf 从模板记录一条可抑制的 ERROR 日志。 (今天)
- fmt.Print 返回给定参数默认的字符串表示。 (今天)
- fmt.Printf 返回按给定格式说明符格式化后的字符串。 (今天)
- fmt.Println 返回给定参数默认的字符串表示,并在末尾附加一个换行。 (今天)
- fmt.Warnf 从模板记录一条 WARNING 日志。 (今天)
- fmt.Warnidf 从模板记录一条可抑制的 WARNING 日志。 (今天)