fmt包实现了类似C语言printf和scanf的格式化I/O。格式化动作(’verb’)源自C语言但更简单。
1 用法
2 基本模式
fmt 方法可以大致分为 print, scan两类, 根据基础方法可以构建特定方法。
- Print 将参数写入字符串或io.writer
- scan 从字符串或 io.Reader 读取指定数据, 并输出
2.1 Printing
普通占位符
| 占位符 | 说明 | 举例 | 输出 | | —- | —- | —- | —- | | %v | 相应值的默认格式 | fmt.Printf(“%v”, name) | {春生} | | %+v | 打印结构体时,会添加字段名 | fmt.Printf(“%+v”, people) | main.Human{Name:”zhangsan”} | | %#v | 相应值的Go语法表示 | fmt.Printf(“%#v”,people) | main.Human{Name:”春生”} | | %T | 相应值的类型的Go语法表示 | fmt.Printf(“%T”,people) | main.Human | | %% | 字面上的百分号 | fmt.Printf(“%%”) | % |
布尔占位符
占位符 | 说明 | 举例 | 输出 |
---|---|---|---|
%t | true 或 false。 | fmt.Printf(“%t”,true) | true |
整数占位符
占位符 | 说明 | 举例 | 输出 |
---|---|---|---|
%b | 二进制表示 | fmt.Printf(“%b”, 5) | 101 |
%c | 相应Unicode码点所表示的字符 | fmt.Printf(“%c”, 0x4E2D) | 中 |
%d | 十进制表示 | fmt.Printf(“%d”, 0x12) | 18 |
%o | 八进制表示 | fmt.Printf(“%d”, 10) | 12 |
%q | 单引号围绕的字符字面值,由Go语法安全地转义 | fmt.Printf(“%q”, 0x4E2D) | ‘中’ |
%x | 十六进制表示,字母形式为小写 a-f | fmt.Printf(“%x”, 13) | d |
%X | 十六进制表示,字母形式为大写 A-F | fmt.Printf(“%x”, 13) | D |
%U | Unicode格式:U+1234,等同于 “U+%04X” | fmt.Printf(“%U”, 0x4E2D) | U+4E2D |
浮点数和复数的组成部分(实部和虚部)
占位符 | 说明 | 举例 |
---|---|---|
%e | (=%.6e) 6位小数点 科学计数法,例如 -1234.456e+78 |
fmt.Printf(“%e”, 10.2) |
%E | 科学计数法,例如 -1234.456E+78 | fmt.Printf(“%e”, 10.2) |
%f | (=%.6f) 6位小数点 有小数点而无指数,例如 123.456 |
fmt.Printf(“%f”, 10.2) |
%g | 根据情况选择 %e 或 %f 以产生更紧凑的(无末尾的0)输出 | fmt.Printf(“%g”, 10.20) |
%G | 根据情况选择 %E 或 %f 以产生更紧凑的(无末尾的0)输出 | fmt.Printf(“%G”, 10.20+2i) |
字符串与字节切片
占位符 | 说明 | 举例 |
---|---|---|
%s | 输出字符串表示(string类型或[]byte) | fmt.Printf(“%s”, []byte(“oldboy”)) |
%10s | 输出字符串最小宽度为10(右对齐) | fmt.Printf(“%10s”, “oldboy”) |
%-10s | 输出字符串最小宽度为10(左对齐) | fmt.Printf(“%-10s”, “oldboy”) |
%.5s | 输出字符串最大宽度为5 | fmt.Printf(“%.5s”, “oldboy”) |
%5.10s | 输出字符串最小宽度为5,最大宽度为10 | fmt.Printf(“%5.10s”, “oldboy”) |
%-5.10s | 输出字符串最小宽度为5,最大宽度为10(左对齐) | fmt.Printf(“%-5.10s”, “oldboy”) |
%5.3s | 输出字符串宽度为5,如果原字符串宽度大于3,则截断 | fmt.Printf(“%5.3s”, “oldboy”) |
%010s | 如果宽度小于10,就会在字符串前面补零 | fmt.Printf(“%010s”, “oldboy”) |
%q | 双引号围绕的字符串,由Go语法安全地转义 | fmt.Printf(“%q”, “oldboy”) |
%x | 十六进制,小写字母,每字节两个字符 | fmt.Printf(“%x”, “oldboy”) |
%X | 十六进制,大写字母,每字节两个字符 | fmt.Printf(“%X”, “oldboy”) |
指针
占位符 | 说明 | 举例 |
---|---|---|
%p | 十六进制表示,前缀 0x | fmt.Printf(“%p”, &site) |
%#p | 不带前缀 0x | fmt.Printf(“%#p”, &site) |
没有%u。整数如果是无符号类型自然输出也是无符号的。类似的,也没有必要指定操作数的尺寸(int8,int64)。
宽度通过一个紧跟在百分号后面的十进制数指定,如果未指定宽度,则表示值时除必需之外不作填充。精度通过(可选的)宽度后跟点号后跟的十进制数指定。如果未指定精度,会使用默认精度;如果点号后没有跟数字,表示精度为0。举例如下:
%f: 默认宽度,默认精度
%9f 宽度9,默认精度
%.2f 默认宽度,精度2
%9.2f 宽度9,精度2
%9.f 宽度9,精度0
宽度和精度格式化控制的是Unicode码值的数量(不同于C的printf,它的这两个因数指的是字节的数量)。两者任一个或两个都可以使用’‘号取代,此时它们的值将被对应的参数(按’‘号和verb出现的顺序,即控制其值的参数会出现在要表示的值前面)控制,这个操作数必须是int类型。
对于大多数类型的值,宽度是输出字符数目的最小数量,如果必要会用空格填充。对于字符串,精度是输出字符数目的最大数量,如果必要会截断字符串。
对于整数,宽度和精度都设置输出总长度。采用精度时表示右对齐并用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字符的输出(通过转义);
' ' 对数值,正数前加空格而负数前加负号;
'-' 在输出右边填充空白而不是默认的左边(即从默认的右对齐切换为左对齐);
'#' 切换格式:
八进制数前加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。例如,因为没有十进制切换模式,所以%#d和%d的输出是相同的
Print 方法的常用几种模式
- 基础模式: [name] Print 返回默认格式化的字符串
- 写入模式: F[name] 返回写入字节 例如: Fprint
- 字符模式: S[name] 返回字符 例如: Sprint
- 模板模式: [name]f 根据模板格式化 例如: Printf
- 换行模式: [name]ln 输出后带换行 例如: Println
- 模式可组合, 例如 Fprintf, Sprintf
例:
func Print
// func Print(a ...interface{}) (n int, err error)
// Print采用默认格式将其参数格式化并写入标准输出。如果两个相邻的参数都不是字符串,会在它们的输出之间添加空格。返回写入的字节数和遇到的任何错误。
fmt.Print("name", 123, []byte("show me"), "\n")
//name123 [115 104 111 119 32 109 101]%
func Printf
// func Printf(format string, a ...interface{}) (n int, err error)
// Printf根据format参数生成格式化的字符串并写入标准输出。返回写入的字节数和遇到的任何错误。
fmt.Printf("name: %s\n", "Jordan")
//name: Jordan
func Fprint
// func Fprint(w io.Writer, a ...interface{}) (n int, err error)
// Fprint采用默认格式将其参数格式化并写入w。如果两个相邻的参数都不是字符串,会在它们的输出之间添加空格。返回写入的字节数和遇到的任何错误。
file, _ := os.OpenFile("./target.txt", os.O_RDWR, os.ModeAppend)
n, err := fmt.Fprint(file, "name", 23,45,54,67,"adrr","12",89,34)
fmt.Println(n, err) //6 <nil>
func Sprint
// func Sprint(a ...interface{}) string
// Sprint采用默认格式将其参数格式化,串联所有输出生成并返回一个字符串。如果两个相邻的参数都不是字符串,会在它们的输出之间添加空格。
str := fmt.Sprint("name: %s", "coco")
fmt.Println(str)
//name: %scoco
2.2 Scanning
一系列类似的函数可以扫描格式化文本以生成值。
Scan、Scanf和Scanln从标准输入os.Stdin读取文本;Fscan、Fscanf、Fscanln从指定的io.Reader接口读取文本;Sscan、Sscanf、Sscanln从一个参数字符串读取文本。
Scanln、Fscanln、Sscanln会在读取到换行时停止,并要求一次提供一行所有条目;Scanf、Fscanf、Sscanf只有在格式化文本末端有换行时会读取到换行为止;其他函数会将换行视为空白。
Scanf、Fscanf、Sscanf会根据格式字符串解析参数,类似Printf。例如%x会读取一个十六进制的整数,%v会按对应值的默认格式读取。格式规则类似Printf,有如下区别:
%p 未实现
%T 未实现
%e %E %f %F %g %G 效果相同,用于读取浮点数或复数类型
%s %v 用在字符串时会读取空白分隔的一个片段
flag '#'和'+' 未实现
在无格式化verb或verb %v下扫描整数时会接受常用的进制设置前缀0(八进制)和0x(十六进制)。
宽度会在输入文本中被使用(%5s表示最多读取5个rune来生成一个字符串),但没有使用精度的语法(没有%5.2f,只有%5f)。
当使用格式字符串进行扫描时,多个连续的空白字符(除了换行符)在输出和输出中都被等价于一个空白符。在此前提下,格式字符串中的文本必须匹配输入的文本;如果不匹配扫描会中止,函数的整数返回值说明已经扫描并填写的参数个数。
在所有的扫描函数里,\r\n都被视为\n。
在所有的扫描函数里,如果一个操作数实现了Scan方法(或者说,它实现了Scanner接口),将会使用该接口为该操作数扫描文本。另外,如果如果扫描到(准备填写)的参数比提供的参数个数少,会返回一个错误。
提供的所有参数必须为指针或者实现了Scanner接口。注意:Fscan等函数可能会在返回前多读取一个rune,这导致多次调用这些函数时可能会跳过部分输入。只有在输入里各值之间没有空白时,会出现问题。如果提供给Fscan等函数的io.Reader接口实现了ReadRune方法,将使用该方法读取字符。如果该io.Reader接口还实现了UnreadRune方法,将是使用该方法保存字符,这样可以使成功执行的Fscan等函数不会丢失数据。如果要给一个没有这两个方法的io.Reader接口提供这两个方法,使用bufio.NewReader。
Scan 方法常用的几种模式
所有方法都返回 写入字节数(n)及错误(err)
- 基础模式: [name] Scan 将输入值写入参数中
- 读取模式: F[name] 从io.Reader 读取数据 例如: Fscan
- 字符模式: S[name] 从字符串读取数据 例如: Sscan
- 模板模式: [name]f 根据模板提取数据 例如: scanf
- 换行模式: [name]ln 以换行符号做读取结束 例如: scanln
例
func Scan
func Scan(a ...interface{}) (n int, err error)
Scan从标准输入扫描文本,将成功读取的空白分隔的值保存进成功传递给本函数的参数。换行视为空白。返回成功扫描的条目个数和遇到的任何错误。如果读取的条目比提供的参数少,会返回一个错误报告原因。
var name string
var age int
// 这里参数需要传入指针类型,获取写入数据
if _, err := fmt.Scan(&name, &age); err != nil{
fmt.Println(err)
return
}
fmt.Printf("name: $s, age: %d", name, age)
// 终端输入 coco 24
// 终端输出 name: coco, age: 24
// 当出入参数数量达到时,跳出输入
func Fscan
func Fscan(r io.Reader, a ...interface{}) (n int, err error)
Fscan从r扫描文本,将成功读取的空白分隔的值保存进成功传递给本函数的参数。换行视为空白。返回成功扫描的条目个数和遇到的任何错误。如果读取的条目比提供的参数少,会返回一个错误报告原因。
// target.js
let name = "coco"
// main.go
var t string
var n string
file, _ := os.Open("./target.js")
fmt.Fscan(file, &t, &n)
// t, n -> let 0
// 以空格作为分割, 当数据不符合类型定义时,返回该类型的默认值
func Scanf
func Scanf(format string, a ...interface{}) (n int, err error)
Scanf从标准输入扫描文本,根据format 参数指定的格式将成功读取的空白分隔的值保存进成功传递给本函数的参数。返回成功扫描的条目个数和遇到的任何错误。
var name string
var age int
fmt.Scanf("name: %s\nage: %d", &name, &age)
fmt.Println(name,'\n', age)
/*
终端输入:
name: coco
age: 24
*/
/*
终端输出:
coco
24
*/
// 当输入不符合指定格式时,将返回错误,跳出输入
func Scanln
func Scanln(a ...interface{}) (n int, err error)
Scanln类似Scan,但会在换行时才停止扫描。最后一个条目后必须有换行或者到达结束位置。
var name string
var age int
fmt.Scanln(&name, &age)
/*
终端输入:
coco 24
[换行, 结束输入]
*/
// name, age -> coco 24