Go fmt

本文最后更新于：2024年3月18日 凌晨

Go fmt

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

输出

标准库 fmt 提供了以下几种输出相关函数。

Print

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

1
2
3
func Print(a ...interface{}) (n int, err error)
func Printf(format string, a ...interface{}) (n int, err error)
func Println(a ...interface{}) (n int, err error)

举个简单的例子：

1
2
3
4
5
6
func main() {
	fmt.Print("在终端打印该信息。")
	name := "沙河小王子"
	fmt.Printf("我是：%s\n", name)
	fmt.Println("在终端打印单独一行显示")
}

执行上面的代码输出：

1
2
在终端打印该信息。我是：沙河小王子。
在终端打印单独一行显示。

Fprint

Fprint 系列函数会将内容输出到一个 io.Writer 接口类型的变量 w 中，我们通常用这个函数往文件中写入内容。

1
2
3
func Fprint(w io.Writer, a ...interface{}) (n int, err error)
func Fprintf(w io.Writer, format string, a ...interface{}) (n int, err error)
func Fprintln(w io.Writer, a ...interface{}) (n int, err error)

举个例子：

1
2
3
4
5
6
7
8
9
10
// 向标准输出写入内容。
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)

注意，只要满足 io.Writer 接口的类型都支持写入。

Sprint

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

1
2
3
func Sprint(a ...interface{}) string
func Sprintf(format string, a ...interface{}) string
func Sprintln(a ...interface{}) string

简单的示例代码如下：

1
2
3
4
5
6
s1 := fmt.Sprint("沙河小王子")
name := "沙河小王子"
age := 18
s2 := fmt.Sprintf("name:%s,age:%d", name, age)
s3 := fmt.Sprintln("沙河小王子")
fmt.Println(s1, s2, s3)

Errorf

Errorf 函数根据 format 参数生成格式化字符串并返回一个包含该字符串的错误。

1
func Errorf(format string, a ...interface{}) error

通常使用这种方式来自定义错误类型，例如：

1
err := fmt.Errorf("这是一个错误")

Go 1.13 版本为 fmt.Errorf 函数新加了一个 %w 占位符用来生成一个可以包裹 Error 的 Wrapping Error。

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

格式化占位符

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

通用占位符

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

示例代码如下：

1
2
3
4
5
6
7
fmt.Printf("%v\n", 100)
fmt.Printf("%v\n", false)
o := struct{ name string }{"小王子"}
fmt.Printf("%v\n", o)
fmt.Printf("%#v\n", o)
fmt.Printf("%T\n", o)
fmt.Printf("100%%\n")
1
2
3
4
5
6
100
false
{小王子}
struct { name string }{name:"小王子"}
struct { name string }
100%

布尔型

占位符 说明
%t true 或 false

整型

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

示例代码如下：

1
2
3
4
5
6
7
n := 65
fmt.Printf("%b\n", n)
fmt.Printf("%c\n", n)
fmt.Printf("%d\n", n)
fmt.Printf("%o\n", n)
fmt.Printf("%x\n", n)
fmt.Printf("%X\n", n)
1
2
3
4
5
6
1000001
A
65
101
41
41

浮点数与复数

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

示例代码如下：

1
2
3
4
5
6
7
f := 12.34
fmt.Printf("%b\n", f)
fmt.Printf("%e\n", f)
fmt.Printf("%E\n", f)
fmt.Printf("%f\n", f)
fmt.Printf("%g\n", f)
fmt.Printf("%G\n", f)
1
2
3
4
5
6
6946802425218990p-49
1.234000e+01
1.234000E+01
12.340000
12.34
12.34

字符串和[]byte

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

示例代码如下：

1
2
3
4
5
s := "小王子"
fmt.Printf("%s\n", s)
fmt.Printf("%q\n", s)
fmt.Printf("%x\n", s)
fmt.Printf("%X\n", s)
1
2
3
4
小王子。
"小王子"
e5b08fe78e8be5ad90
E5B08FE78E8BE5AD90

指针

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

示例代码如下：

1
2
3
a := 10
fmt.Printf("%p\n", &a)
fmt.Printf("%#p\n", &a)
1
2
0xc000094000
c000094000

宽度标识符

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

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

示例代码如下：

1
2
3
4
5
6
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)
1
2
3
4
5
12.340000
12.340000
12.34
    12.34
       12

其他 flag

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

示例代码如下：

1
2
3
4
5
6
7
8
s := "小王子"
fmt.Printf ("%s\n", s)
fmt.Printf ("%5 s\n", s)
fmt.Printf ("%-5 s\n", s)
fmt.Printf ("%5.7 s\n", s)
fmt.Printf ("%-5.7 s\n", s)
fmt.Printf ("%5.2 s\n", s)
fmt.Printf ("%05 s\n", s)
1
2
3
4
5
6
7
小王子。
  小王子。
小王子  
  小王子。
小王子  
   小王。
00 小王子。

输入

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

fmt. Scan

函数签名如下：

1
func Scan (a ... interface{}) (n int, err error)
  • Scan 从标准输入扫描文本，读取由空白符分隔的值保存到传递给本函数的参数中，换行符视为空白符。
  • 本函数返回成功扫描的数据个数和遇到的任何错误。如果读取的数据个数比提供的参数少，会返回一个错误报告原因。

具体代码示例如下：

1
2
3
4
5
6
7
8
9
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)
}

将上面的代码编译后在终端执行，在终端依次输入小王子、28和false使用空格分隔。

1
2
3
$ ./scan_demo 
小王子 28 false
扫描结果 name：小王子 age: 28 married: false

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

fmt. Scanln

函数签名如下：

1
func Scanln (a ... interface{}) (n int, err error)
  • Scanln 类似 Scan，它在遇到换行时才停止扫描。最后一个数据后面必须有换行或者到达结束位置。
  • 本函数返回成功扫描的数据个数和遇到的任何错误。

具体代码示例如下：

1
2
3
4
5
6
7
8
9
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)
}

将上面的代码编译后在终端执行，在终端依次输入小王子、28和false使用空格分隔。

1
2
3
$ ./scan_demo 
小王子 28 false
扫描结果 name：小王子 age: 28 married: false

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

fmt. Scanf

函数签名如下：

1
func Scanf (format string, a ... interface{}) (n int, err error)
  • Scanf 从标准输入扫描文本，根据 format 参数指定的格式去读取由空白符分隔的值保存到传递给本函数的参数中。
  • 本函数返回成功扫描的数据个数和遇到的任何错误。

代码示例如下：

1
2
3
4
5
6
7
8
9
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)
}

将上面的代码编译后在终端执行，在终端按照指定的格式依次输入小王子、28和false。

1
2
3
$ ./scan_demo 
1：小王子 2:28 3:false
扫描结果 name：小王子 age: 28 married: false

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

例如，我们还是按照上个示例中以空格分隔的方式输入，fmt. Scanf就不能正确扫描到输入的数据。

1
2
3
$ ./scan_demo 
小王子 28 false
扫描结果 name: age: 0 married: false

bufio. NewReader

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

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

Fscan 系列

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

1
2
3
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)

Sscan 系列

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

1
2
3
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)
Software Language Go Library

本博客所有文章除特别声明外，均采用 CC BY-SA 4.0 协议 ，转载请注明出处！