一文搞懂Go语言标准库，fmt

微客鸟窝
1,706 阅读7分钟

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

fmt 包含有格式化I/O函数，类似于C语言的 printf 和 scanf。主要分为向外输出内容和获取输入内容两大部分。

输出

Print

Print 系列函数会将内容输出到系统的标准输出。

  • Print 函数直接输出内容。
  • Println 函数会在输出内容的结尾添加一个换行符。
  • Printf 函数支持格式化输出字符串。
func Print(a ...interface{}) (n int, err error)
func Println(a ...interface{}) (n int, err error)
func Printf(format string, a ...interface{}) (n int, err error)

举例说明：

func main() {
    fmt.Print("直接输出内容", "\n") // \n :手动换行
    fmt.Println("自动加换行")
    name := "微客鸟窝"
    fmt.Printf("我是：%s\n", name)
}

运行结果：

直接输出内容
自动加换行
我是：微客鸟窝

Fprint

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("./xxx.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 系列函数会把传入的数据生成并返回一个字符串。

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

举例说明：

func main() {
	  s1 := fmt.Sprint("微客鸟窝")
	  name := "微客鸟窝"
	  age := 18
	  s2 := fmt.Sprintf("name:%s,age:%d", name, age)
	  s3 := fmt.Sprintln("微客鸟窝")
	  s4 := fmt.Sprintln("微客鸟窝")
	  fmt.Println(s1, s2, s3, s4)
}

运行结果：

微客鸟窝 name:微客鸟窝,age:18 微客鸟窝
 微客鸟窝

Errorf

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

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

我们通常使用这种方式来自定义错误类型：

func main() {
    err := fmt.Errorf("错误码:%d", 404) 
    fmt.Println("发生一个错误，", err) 
}

运行结果：

发生一个错误， 错误码:404

格式化占位符

*printf 系列函数都支持format格式化参数。

通用占位符

占位符说明示例
%v值的默认格式表示fmt.Printf("%v\n", 100)}
//100
%+v类似%v，但输出结构体时会添加字段名o := struct{ name string }{"微客"}
fmt.Printf("%+v\n", o)}}
//{name:微客}
%#v值的Go语法表示o := struct{ name string }{"微客"}
fmt.Printf("%#v\n", o) }
//struct { name string }{name:"微客"}
%T打印值的类型o := struct{ name string }{"微客"}
fmt.Printf("%T\n", o) }
//struct { name string }
%%百分号fmt.Printf("100%%\n") }
//100%

布尔型

占位符说明
%ttrue或false

整型

占位符说明示例
%b表示为二进制fmt.Printf("%b\n", 65)
//1000001
%c该值对应的unicode码值fmt.Printf("%c\n", 65)
//A
%d表示为十进制fmt.Printf("%d\n", 65)
//65
%o表示为八进制fmt.Printf("%o\n", 65)
//101
%x表示为十六进制，使用a-ffmt.Printf("%x\n", 65)
//41
%X表示为十六进制，使用A-Ffmt.Printf("%X\n", 65)
//41
%U表示为Unicode格式：U+1234，等价于”U+%04X”
%q该值对应的单引号括起来的go语法字符字面值
必要时会采用安全的转义表示		fmt.Printf("%q\n", 65)
//'A'

浮点数与复数

占位符说明示例
%b无小数部分、二进制指数的科学计数法，如-123456p-78fmt.Printf("%b\n", 12.34)
//6946802425218990p-49
%e科学计数法，如-1234.456e+78fmt.Printf("%e\n", f)
//1.234000e+01
%E科学计数法，如-1234.456E+78fmt.Printf("%E\n", f)
//1.234000E+01
%f有小数部分但无指数部分，如123.456fmt.Printf("%f\n", f)
//12.340000
%F等价于%ffmt.Printf("%F\n", 12.34)
//12.340000
%g根据实际情况采用%e或%f格式（以获得更简洁、准确的输出）fmt.Printf("%g\n", f)
//12.34
%G根据实际情况采用%E或%F格式（以获得更简洁、准确的输出）fmt.Printf("%G\n", f)
//12.34

字符串和[]byte

占位符说明示例
%s直接输出字符串或者[]bytefmt.Printf("%s\n", "微客")
//微客
%q该值对应的双引号括起来的go语法字符串字面值，必要时会采用安全的转义表示fmt.Printf("%q\n", "微客")
//"微客"
%x每个字节用两字符十六进制数表示（使用a-ffmt.Printf("%x\n", "微客")
//e5beaee5aea2
%X每个字节用两字符十六进制数表示（使用A-F）fmt.Printf("%X\n", "微客")
//E5BEAEE5AEA2

指针

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

宽度标识符

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

其他falg

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

输入

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

fmt.Scan

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

举例说明：

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

将上面的代码编译后在终端执行，在终端依次输入微客鸟窝、18使用空格分隔。

$ ./scan_demo 
微客鸟窝 18
扫描结果 name:微客鸟窝 age:18

fmt.Scanf

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

举例说明：

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

将上面的代码编译后在终端执行，在终端按照指定的格式依次输入微客鸟窝、18。

$ ./scan_demo 
1:微客鸟窝 2:18
扫描结果 name:微客鸟窝 age:18

fmt.Scanln

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

举例说明：

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

将上面的代码编译后在终端执行，在终端依次输入微客鸟窝、18使用空格分隔。

$ ./scan_demo 
微客鸟窝 18
扫描结果 name:微客鸟窝 age:18

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)
}

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)

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)
``
avatar
文章
阅读
粉丝