fmt包

135 阅读6分钟

持续创作,加速成长!这是我参与「掘金日新计划 · 6 月更文挑战」的第28天,点击查看活动详情

1.fmt包格式化I/O

在fmt包,有关格式化输入输出的方法就两大类:Scan 和 Print ,分别在scan.go 和 print.go 文件中。print.go文件中定义了如下函数:

func Printf(format string,  a ...interface{}) (n int,  err error)
func Fprintf(w io.Writer,  format string,  a ...interface{}) (n int,  err error)
func Sprintf(format string,  a ...interface{}) string
func Print(a ...interface{}) (n int,  err error)
func Fprint(w io.Writer,  a ...interface{}) (n int,  err error)
func Sprint(a ...interface{}) string
func Println(a ...interface{}) (n int,  err error)
func Fprintln(w io.Writer,  a ...interface{}) (n int,  err error)
func Sprintln(a ...interface{}) string

这9个函数,按照两个维度来说明,基本上可以说明白了。当然这两个维度是我个人为了记忆而分,并不是官方的说法。

1.如果把”Print”理解为核心关键字,那么后面跟的后缀有”f”和”ln”以及””,着重的是内容输出的结果;如果后缀是”f”, 则指定了format如果后缀是”ln”, 则有换行符

Println、Fprintln、Sprintln 输出内容时会加上换行符;
Print、Fprint、Sprint        输出内容时不加上换行符;
Printf、Fprintf、Sprintf    按照指定格式化文本输出内容。

2.如果把”Print”理解为核心关键字,那么前面的前缀有”F”和”S”以及””,着重的是输出内容的来源;

如果前缀是”F”, 则指定了io.Writer 如果前缀是”S”, 则是输出到字符串

Print、Printf、Println      输出内容到标准输出os.Stdout;
Fprint、Fprintf、Fprintln  输出内容到指定的io.Writer;
Sprint、Sprintf、Sprintln  输出内容到字符串。

scan.go文件中定义了如下函数:

func Scanf(format string,  a ...interface{}) (n int,  err error)
func Fscanf(r io.Reader,  format string,  a ...interface{}) (n int,  err error)
func Sscanf(str string,  format string,  a ...interface{}) (n int,  err error)
func Scan(a ...interface{}) (n int,  err error)
func Fscan(r io.Reader,  a ...interface{}) (n int,  err error)
func Sscan(str string,  a ...interface{}) (n int,  err error)
func Scanln(a ...interface{}) (n int,  err error)
func Fscanln(r io.Reader,  a ...interface{}) (n int,  err error)
func Sscanln(str string,  a ...interface{}) (n int,  err error)

这9个函数可以扫描格式化文本以生成值。同样也可以按照两个维度来说明。

一:如果把”Scan”理解为核心关键字,那么后面跟的后缀有”f”和”ln”以及””,着重的是输入内容的结果;

如果后缀是”f”, 则指定了format 如果后缀是”ln”, 则有换行符

Scanln、Fscanln、Sscanln   读取到换行时停止,并要求一次提供一行所有条目;Scan、Fscan、Sscan          读取内容时不关注换行;Scanf、Fscanf、Sscanf      根据格式化文本读取。

二:如果把”Scan”理解为核心关键字,那么前面的前缀有”F”和”S”以及””,着重的是输入内容的来源;

如果前缀是”F”, 则指定了io.Reader 如果前缀是”S”, 则是从字符串读取

Scanln、Fscanln、Sscanln   读取到换行时停止,并要求一次提供一行所有条目;
Scan、Fscan、Sscan          读取内容时不关注换行;
Scanf、Fscanf、Sscanf      根据格式化文本读取。
2.格式化verb应用

在应用上,我们主要讲讲格式化verb ,fmt包中格式化的主要功能函数都在format.go文件中。

我们先来了解下有哪些verb:

通用:

  • %v 值的默认格式表示。当输出结构体时,扩展标志(%+v)会添加字段名
  • %#v 值的Go语法表示
  • %T 值的类型的Go语法表示
  • %% 百分号
  • 布尔值:%t 单词true或false
  • 整数: %b 表示为二进制
  • %c 该值对应的unicode码值
  • %d 表示为十进制
  • %o 表示为八进制
  • %q 该值对应的单引号括起来的go语法字符字面值,必要时会采用安全的转义表示 %x 表示为十六进制,使用a-f %X 表示为十六进制,使用A-F %U 表示为Unicode格式:U+1234,等价于"U+%04X" 浮点数、复数的两个组分: %b 无小数部分、二进制指数的科学计数法,如-123456p-78;参见strconv.FormatFloat
  • %e 科学计数法,如-1234.456e+78
  • %E 科学计数法,如-1234.456E+78
  • %f 有小数部分 但无指数部分,如123.456
  • %F 等价于%f
  • %g 根据实际情况采用%e或%f格式(以获得 更简洁、准确的输出)
  • %G 根据实际情况采用%E或%F格式(以获得更简洁、准确的输出)
  • 字符串和[]byte:
  • %s 直接输出字符串或者[]byte
  • %q 该值对应的双引号括起来的Go语法字符串字面值,必要时会采用安全的转义表示
  • %x 每个字节用两字符十六进制数表示(使用a-f)
  • %X 每个字节用两字符十六进制数表示(使用A-F)
  • 指针: %p 表示为十六进制,并加上前导的0x
  • 宽度通过一个紧跟在百分号后面的十进制数指定,如果未指定宽度,则表示值时除必需之外不作填充。精度通过(可能有的)宽度后跟点号后跟的十进制数指定。如果未指定精度,会使用默认精度;如果点号后没有跟数字,表示精度为0。举例如下: %f: 默认宽度,默认精度 %9f 宽度9,默认精度 %.2f 默认宽度,精度2 %9.2f 宽度9,精度2 %9.f 宽度9,精度0
  • 对于整数,宽度和精度都设置输出总长度。采用精度时表示右对齐并用0填充,而宽度默认表示用空格填充。
  • 对于浮点数,宽度设置输出总长度;精度设置小数部分长度(如果有的话),除了%g/%G,此时精度设置总的数字个数。例如,
  • 对数字123.45,格式%6.2f 输出123.45;格式%.4g输出123.5。%e和%f的默认精度是6,%g的默认精度是可以将该值区分出来需要的最小数字个数。
  • 对复数,宽度和精度会分别用于实部和虚部,结果用小括号包裹。因此%f用于1.2+3.4i输出(1.200000+3.400000i)。 其它flag:
  • 总是输出数值的正负号;对%q(%+q)会生成全部是ASCII字符的输出(通过转义);
  • 在输出右边填充空白而不是默认的左边(即从默认的右对齐切换为左对齐);

切换格式

  • 总是输出数值的正负号;对%q(%+q)会生成全部是ASCII字符的输出(通过转义);
  • 在输出右边填充空白而不是默认的左边(即从默认的右对齐切换为左对齐);

切换格式

八进制数前加0(%#o),十六进制数前加0x(%#x)或0X(%#X),指针去掉前面的 0x(%#p);对%q(%#q),如果strconv.CanBackquote返回真会输出反引号括起来的未转义字符串;对%U(%#U),如果字符是可打印的,会在输出Unicode格式、空格、单引号括起来 的go字面值;

' ' 对数值,正数前加空格而负数前加负号; 对字符串采用%x或%X时(% x或% X)会给各打印的字节之间加空格;0 使用0而不是空格填充,对于数值类型会把填充的0放在正负号后面;verb会忽略不支持的flag。