Go语言fmt.Printf使用指南

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

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

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

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)

举个简单的例子：
func main() {
	fmt.Print("在终端打印该信息。")
	name := "沙河小王子"
	fmt.Printf("我是：%s\n", name)
	fmt.Println("在终端打印单独一行显示")
}
执行上面的代码输出：
在终端打印该信息。我是：沙河小王子
在终端打印单独一行显示

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

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)

举个例子：
// 向标准输出写入内容
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系列变量会把传入的数据生成并返回一个字符串。

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

简单的示例代码如下：
s1 := fmt.Sprint("沙河小王子")
name := "沙河小王子"
age := 18
s2 := fmt.Sprintf("name:%s,age:%d", name, age)
s3 := fmt.Sprintln("沙河小王子")
fmt.Println(s1, s2, s3)

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

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

通常使用这些方法来自定义出错类型，例如：

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

*printf系列数组都支持format格式化参数，在这里我们根据占位符将被更换的数组类型划分printf 科学计数法，方便查询和记忆。

占位符说明

值的默认格式表示

类似%vprintf 科学计数法，但输出结构体时会添加字段名

值的Go语法表示

打印值的类型

百分号

示例代码如下：
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")
输出结果如下：
100
false
{小王子}
struct { name string }{name:"小王子"}
struct { name string }
100%

占位符说明

true或false

占位符说明

表示为二进制

该值对应的unicode码值

表示为无符号十进制

表示为无符号八进制

表示为有符号八进制

表示为十六进制，使用a-f

表示为有符号的十六进制

表示为十六进制，使用A-F

表示为Unicode格式：U+1234，等价于”U+X”

表示带打印字符的Unicode

该值对应的单引号括起来的go语法字符字面值，必要时会采取安全的转义表示

示例代码如下：
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)
输出结果如下：
1000001
A
65
101
41
41

占位符说明

无小数部分、二进制指数的科学计数法，如-123456p-78

科学计数法，如-1234.456e+78

科学计数法，如-1234.456E+78

有小数部分但无指数部分，如123.456

等价于%f

根据实际状况采取%e或%f格式（以获取更简单、准确的输出）

根据实际状况采取%E或%F格式（以获取更简单、准确的输出）

示例代码如下：
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)
输出结果如下：
6946802425218990p-49
1.234000e+01
1.234000E+01
12.340000
12.34
12.34

字符串和[]byte

占位符说明

直接输出字符串或者[]byte

该值对应的双引号括起来的go语法字符串字面值，必要时会采取安全的转义表示

每个字节用两数组十六进制数表示（使用a-f

每个字节用两数组十六进制数表示（使用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

占位符说明

表示为十六进制，并加上前导的0x

表示为十六进制,不加上前导0x

示例代码如下：

a := 10
fmt.Printf("%p\n", &a)
fmt.Printf("%#p\n", &a)
输出结果如下：
0xc000094000
c000094000

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

占位符说明

默认宽度，默认精度

宽度9，默认精度

默认宽度，精度2

%9.2f

宽度9，精度2

宽度9，精度0

最多出现2个数

示例代码如下：
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

占位符说明

’+’

总是输出数值的正负号；对%q（%+q）会生成全部是ASCII字符的输出（通过转义）；

’ ‘

对数值，正数前加括号而负数前加减号；对字符串采用%x或%X时（% x或% X）会给各打印的字节之间加空格

’-’

在输出后面填充空白而不是默认的右边（即从默认的右对齐切换为左对齐）；

’#’

八进制数前加0（%#o），十六进制数前加0x（%#x）或0X（%#X），指针去掉上面的0x（%#p）对%q（%#q），对%U（%#U）会输出空格和单引号括出来的go字面值；

‘0’

使用0而不是空格填充，对于数值类型会把填充的0放在正负号后面；

举个例子：

s := "小王子"
fmt.Printf("%s\n", s)
fmt.Printf("%5s\n", s)
fmt.Printf("%-5s\n", s)
fmt.Printf("%5.7s\n", s)
fmt.Printf("%-5.7s\n", s)
fmt.Printf("%5.2s\n", s)
fmt.Printf("s\n", s)
输出结果如下：

小王子
  小王子
小王子  
  小王子
小王子  
   小王
00小王子

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

函数定签名如下：

func Scan(a ...interface{}) (n int, err error)

具体代码实例如下：

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使用空格分隔。

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

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

函数签名如下：

func Scanf(format string, a ...interface{}) (n int, err error)

代码实例如下：

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。

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

fmt.Scanf不同于fmt.Scan简单的以括号作为输入数据的分隔符，fmt.Scanf为输入数据指定了详细的输入内容格式，只有根据格式输入数据就会被扫描并存入对应变量。

例如，我们而是根据上个例子中以空格分割的方法输入，fmt.Scanf就不能正确扫描到输入的数据。

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

函数签名如下：

func Scanln(a ...interface{}) (n int, err error)

具体代码实例如下：

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使用空格分隔。

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

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

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

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

这几个函数功能分别类似于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)

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

本文来自电脑杂谈，转载请注明本文网址：
https://www.pc-fly.com/a/ruanjian/article-130464-1.html