Go -- fmt标准库使用

fmt使用介绍

• fmt包实现了类似C语言printf和scanf的格式化I/O。主要分为向外输出内容和获取输入内容两大部分。

1、向外输出

1.1、Print系列

• Print系列函数会将内容输出到系统的标准输出，区别在于Print函数直接输出内容，Printf函数支持格式化输出字符串，Println函数会在输出内容的结尾添加一个换行符。

func main() {
	// print 输出的内容不会换行
	fmt.Print("a ")
	fmt.Print("b\n")

	// println 输出的内容自动换行
	fmt.Println("b")
	fmt.Println("c")

	// printf 具有格式化功能
	var n = 100
	var f = 1.1234
	var s = "abv"
	fmt.Printf("%T\n", n)    // 查看类型 int
	fmt.Printf("%v\n", n)    // 查看变量值 100
	fmt.Printf("%#v\n", n)   // #v，可以根据数据类型加上描述符（如字符串就会加上引号）  100
	fmt.Printf("%#v\n", s)   // #v，可以根据数据类型加上描述符（如字符串就会加上引号）  "abv"
	fmt.Printf("%b\n", n)    // 查看二进制值 1100100
	fmt.Printf("%d\n", n)    // 查看十进制值 100
	fmt.Printf("%o\n", n)    // 查看八进制值 144
	fmt.Printf("%x\n", n)    // 查看十六进制值 64
	fmt.Printf("%s\n", s)    // 查看字符串 abv
	fmt.Printf("%f\n", f)    // 浮点型
	fmt.Printf("%p\n", (&s)) // 指针
}

1.2、Fprint

• Fprint系列函数会将内容输出到一个 io.Writer 接口类型的变量 w 中，我们通常用这个函数往文件中写入内容。
• 注意，只要满足io.Writer接口的类型都支持写入。
  示例：

// 向标准输出写入内容
fmt.Fprintln(os.Stdout, "向标准输出写入内容")
fileObj, err := os.OpenFile("./xx.txt", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
if err != nil {
	fmt.Println("打开文件出错，err:", err)
	return
}
name := "小明"
// 向打开的文件句柄中写入内容
fmt.Fprintf(fileObj, "往文件中写如信息：%s", name)

1.3、Sprint

• Sprint 系列函数会把传入的数据生成并返回一个字符串。
  示例：

s1 := fmt.Sprint("小明")
name := "小明"
age := 18
s2 := fmt.Sprintf("name:%s,age:%d", name, age)
s3 := fmt.Sprintln("小明")
fmt.Println(s1, s2, s3)

1.4、Errorf

• Errorf 函数根据 format 参数生成格式化字符串并返回一个包含该字符串的错误。
• 示例：err := fmt.Errorf("这是一个错误")
• Go1.13版本为fmt.Errorf函数新加了一个%w占位符用来生成一个可以包裹Error的Wrapping Error。
  示例：

e := errors.New("原始错误e")
w := fmt.Errorf("Wrap了一个错误%w", e)

2、格式化占位符

• *printf 系列函数都支持 format 格式化参数，在这里我们按照占位符将被替换的变量类型划分，方便查询和记忆。

2.1、通用占位符

占位符	说明
%v	值的默认格式表示
%+v	类似%v，但输出结构体时会添加字段名
%#v	值的Go语法表示
%T	打印值的类型
%%	百分号

示例代码如下：

fmt.Printf("%v\n", 100)  // 100
fmt.Printf("%v\n", false)  // false
o := struct{ name string }{"小王子"} 
fmt.Printf("%v\n", o)  // {小王子}
fmt.Printf("%#v\n", o)  // struct { name string }{name:"小王子"}
fmt.Printf("%T\n", o)  // struct { name string }
fmt.Printf("100%%\n")  // 100%

2.2、布尔型

占位符	说明
%t	true或false

2.3、整型

占位符	说明
%b	表示为二进制
%c	该值对应的unicode码值
%d	表示为十进制
%o	表示为八进制
%x	表示为十六进制，使用a-f
%X	表示为十六进制，使用A-F
%U	表示为Unicode格式：U+1234，等价于”U+%04X”
%q	该值对应的单引号括起来的go语法字符字面值，必要时会采用安全的转义表示（和%c类似）

示例：

unc main() {
	n := 65
	fmt.Printf("%b\n", n)  // 1000001
	fmt.Printf("%c\n", n)  // A
	fmt.Printf("%q\n", n)  // 'A'
	fmt.Printf("%d\n", n)  // 65
	fmt.Printf("%o\n", n)  // 101
	fmt.Printf("%x\n", n)  // 41
	fmt.Printf("%X\n", n)  // 41 
}

2.4、浮点数与复数

占位符	说明
%b	无小数部分、二进制指数的科学计数法，如-123456p-78
%e	科学计数法，如-1234.456e+78
%E	科学计数法，如-1234.456E+78
%f	有小数部分但无指数部分，如123.456
%F	等价于%f
%g	根据实际情况采用%e或%f格式（以获得更简洁、准确的输出）
%G	根据实际情况采用%E或%F格式（以获得更简洁、准确的输出）

示例:

f := 12.34
fmt.Printf("%b\n", f) // 6946802425218990p-49
fmt.Printf("%e\n", f)  // 1.234000e+01
fmt.Printf("%E\n", f)  // 1.234000E+01
fmt.Printf("%f\n", f)  // 12.340000
fmt.Printf("%g\n", f)  // 12.34
fmt.Printf("%G\n", f)  // 12.34

2.5、字符串和[]byte

占位符	说明
%s	直接输出字符串或者[]byte
%q	该值对应的双引号括起来的go语法字符串字面值，必要时会采用安全的转义表示
%x	每个字节用两字符十六进制数表示（使用a-f
%X	每个字节用两字符十六进制数表示（使用A-F）

示例：

s := "小王子"
fmt.Printf("%s\n", s)
fmt.Printf("%q\n", s)
fmt.Printf("%x\n", s)
fmt.Printf("%X\n", s)

输出结果

小王子
"小王子"
e5b08fe78e8be5ad90
E5B08FE78E8BE5AD90

2.6、指针

占位符	说明
%p	表示为十六进制，并加上前导的0x

示例：

a := 10
fmt.Printf("%p\n", &a)  // 0xc000094000

fmt.Printf("%#p\n", &a)  // c000094000

2.7、宽度标识符

• 宽度通过一个紧跟在百分号后面的十进制数指定，如果未指定宽度，则表示值在除必需之外不作填充。
• 精度通过（可选的）宽度后跟点号后跟的十进制数指定。如果未指定精度，会使用默认精度；如果点号后没有跟数字，表示精度为0

占位符	说明
%f	默认宽度，默认精度
%9f	宽度9，默认精度
%.2f	默认宽度，精度2
%9.2f	宽度9，精度2
%9.f	宽度9，精度0

示例：

n := 12.34
fmt.Printf("%f\n", n)
fmt.Printf("%9f\n", n)
fmt.Printf("%.2f\n", n)
fmt.Printf("%9.2f\n", n)
fmt.Printf("%9.f\n", n)

输出结果

12.340000
12.340000
12.34
    12.34
       12

2.8、其他flag标志位

占 位 符	说明
‘+’	总是输出数值的正负号；对%q（%+q）会生成全部是ASCII字符的输出（通过转义）；
‘’	对数值，正数前加空格而负数前加负号；对字符串采用%x或%X时（% x或% X）会给各打印的字节之间加空格
‘-’	在输出右边填充空白而不是默认的左边（即从默认的右对齐切换为左对齐）；
‘#’	八进制数前加0（%#o），十六进制数前加0x（%#x）或0X（%#X），指针去掉前面的0x（%#p）对%q（%#q），对%U（%#U）会输出空格和单引号括起来的go字面值；
‘0’	使用0而不是空格填充，对于数值类型会把填充的0放在正负号后面；

示例：

func main() {
	s := "小红帽"
	fmt.Printf("%s1\n", s)
	fmt.Printf("%5s2\n", s)
	fmt.Printf("%-5s3\n", s)   // 默认是右对齐，加上-号后，就是左对齐了
	fmt.Printf("%2.7s4\n", s)  // %2.7s 表示占位长度为2，可以保留传入字符的7位字符，实际传入的字符长度最大可为7
	fmt.Printf("%-2.7s5\n", s)
	fmt.Printf("%5.2s6\n", s) // %5.2s 表示占位长度为5，保留传入字符的两位字符
	fmt.Printf("%05s7\n", s)  // 空白位用0填充
}

输出结果

小红帽1
  小红帽2
小红帽  3
小红帽4
小红帽5
   小红6
00小红帽7

3、获取输入

• Go语言fmt包下有fmt.Scan、fmt.Scanf、fmt.Scanln三个函数，可以在程序运行过程中从标准输入获取用户的输入。

3.1、fmt.Scan（类似python的input）

• Scan从标准输入扫描文本，读取由空白符分隔的值保存到传递给本函数的参数中，换行符视为空白符。(即将输入的字符传递给变量接收)
• 本函数返回成功扫描的数据个数和遇到的任何错误。如果读取的数据个数比提供的参数少，会返回一个错误报告原因。

示例：

func main() {
	var (
		name    string
		age     int
		married bool
	)
	fmt.Scan(&name, &age, &married)
	fmt.Printf("扫描结果 name:%s age:%d married:%t \n", name, age, married)
}

执行结果：

• fmt.Scan从标准输入中扫描用户输入的数据，将以空白符分隔的数据分别存入指定的参数。

小王 35  true         // 在终端输入这些内容
扫描结果 name:小王 age:35 married:true

3.2、fmt.Scanf

• Scanf从标准输入扫描文本，根据format参数指定的格式去读取由空白符分隔的值保存到传递给本函数的参数中。
• 本函数返回成功扫描的数据个数和遇到的任何错误。

示例：

func main() {
	var (
		name    string
		age     int
		married bool
	)
	fmt.Scanf("1:%s 2:%d 3:%t", &name, &age, &married)
	fmt.Printf("扫描结果 name:%s age:%d married:%t \n", name, age, married)
}

执行结果：

• fmt.Scanf 不同于 fmt.Scan 简单的以空格作为输入数据的分隔符，fmt.Scanf为输入数据指定了具体的输入内容格式，只有按照格式输入数据才会被扫描并存入对应变量（也可以不指定具体输入格式）。

1:小王 2:33 3:true    // 在终端输入这些内容
扫描结果 name:小王 age:33 married:true

3.3、fmt.Scanln

• Scanln类似Scan，它在遇到换行时才停止扫描。最后一个数据后面必须有换行或者到达结束位置。
• 本函数返回成功扫描的数据个数和遇到的任何错误。

示例：

func main() {
	var (
		name    string
		age     int
		married bool
	)
	fmt.Scanln(&name, &age, &married)
	fmt.Printf("扫描结果 name:%s age:%d married:%t \n", name, age, married)
}

输出结果

• fmt.Scanln遇到回车就结束扫描了，这个比较常用

小明 23 false
扫描结果 name:小明 age:23 married:false

3.4、bufio.NewReader

• 有时候我们想完整获取输入的内容，而输入的内容可能包含空格，这种情况下可以使用 bufio 包来实现。

示例：

func bufioDemo() {
	reader := bufio.NewReader(os.Stdin) // 从标准输入生成读对象
	fmt.Print("请输入内容：")
	text, _ := reader.ReadString('\n') // 读到换行
	text = strings.TrimSpace(text)
	fmt.Printf("%#v\n", text)
}

3.5、Fscan系列

• 这几个函数功能分别类似于fmt.Scan、fmt.Scanf、fmt.Scanln三个函数，只不过它们不是从标准输入中读取数据而是从io.Reader中读取数据。

源代码签名如下

func Fscan(r io.Reader, a ...interface{}) (n int, err error)
func Fscanln(r io.Reader, a ...interface{}) (n int, err error)
func Fscanf(r io.Reader, format string, a ...interface{}) (n int, err error)

3.6、Sscan系列

• 这几个函数功能分别类似于fmt.Scan、fmt.Scanf、fmt.Scanln三个函数，只不过它们不是从标准输入中读取数据而是从指定字符串中读取数据。

源代码签名如下

func Sscan(str string, a ...interface{}) (n int, err error)
func Sscanln(str string, a ...interface{}) (n int, err error)
func Sscanf(str string, format string, a ...interface{}) (n int, err error)