Go语言的fmt包中文教程

Fmt包

import "fmt"

简介 ▾

Package fmt包含有格式化I/O函数,类似于C语言的printf和scanf。格式字符串的规则来源于C但更简单一些。

输出

格式:

一般:

%v 基本格式的值。当输出结构体时,扩展标志(%+v)添加成员的名字。the value in a default format.

when printing structs, the plus flag (%+v) adds field names

%#v 值的Go语法表示。

%T 值的类型的Go语法表示。

%% 百分号。

布尔型:

%t 值的true或false

整型:

%b 二进制表示

%c 数值对应的Unicode编码字符

%d 十进制表示

%o 八进制表示

%q 单引号

%x 十六进制表示,使用a-f

%X 十六进制表示,使用A-F

%U Unicode格式: U+1234,等价于"U+%04X"

浮点数:

%b 无小数部分、两位指数的科学计数法,和strconv.FormatFloat的'b'转换格式一致。举例:-123456p-78

%e 科学计数法,举例:-1234.456e+78

%E 科学计数法,举例:-1234.456E+78

%f 有小数部分,但无指数部分,举例:123.456

%g 根据实际情况采用%e或%f格式(以获得更简洁的输出)

%G 根据实际情况采用%E或%f格式(以获得更简洁的输出)

字符串和byte切片类型:

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

%q 双引号括起来的字符串

%x 每个字节用两字符十六进制数表示(使用小写a-f)

%X 每个字节用两字符十六进制数表示(使用大写A-F)

指针:

%p 0x开头的十六进制数表示

木有'u'标志。如果是无类型整数,自然会打印无类型格式。类似的,没有必要去区分操作数的大小(int8, int64)。

宽度和精度格式化控制是指的Unicode编码字符的数量(不同于C的printf,它的这两个因子指的是字节的数量。)两者均可以使用'*'号取代(任一个或两个都),此时它们的值将被紧接着的参数控制,这个操作数必须是整型。

对于数字,宽度设置总长度,精度设置小数部分长度。例如,格式%6.2f 输出123.45。

对于字符串,宽度是输出字符数目的最低数量,如果不足会用空格填充。精度是输出字符数目的最大数量,超过则会截断。

其它符号:

+ 总是输出数值的正负号;对%q(%+q)将保证纯ASCII码输出

- 用空格在右侧填充空缺而不是默认的左侧。

# 切换格式:在八进制前加0(%#o),十六进制前加0x(%#x)或0X(%#X);废除指针的0x(%#p);

对%q (%#q)如果可能的话输出一个无修饰的字符串;

对%U(%#U)如果对应数值是可打印字符输出该字符。

' ' 对数字(% d)空格会留一个空格在数字前并忽略数字的正负号;

对切片和字符串(% x, % X)会以16进制输出。

0 用前置0代替空格填补空缺。

每一个类似Printf的函数,都会有一个同样的Print函数,此函数不需要format字符串,等价于对每一个参数设置为%v。另一个变体Println会在参数之间加上空格并在输出结束后换行。

如果参数是一个接口值,将使用内在的具体实现的值,而不是接口本身,%v参数不会被使用。如下:

var i interface{} = 23

fmt.Printf("%v\n", i)

将输出23。

如果参数实现了Formatter接口,该接口可用来更好的控制格式化。

如果格式(标志对Println等是隐含的%v)是专用于字符串的(%s %q %v %x %X),还提供了如下两个规则:

1. 如果一个参数实现了error接口,Error方法会用来将目标转化为字符串,随后将被按给出的要求格式化。

2. 如果参数提供了String方法,这个方法将被用来将目标转换为字符串,然后将按给出的格式标志格式化。

为了避免有可能的递归循环,例如:

type X string

func (x X) String() string { return Sprintf("<%s>", x) }

会在递归循环前转换值:

func (x X) String() string { return Sprintf("<%s>", string(x)) }

错误的格式:

如果提供了一个错误的格式标志,例如给一个字符串提供了%d标志,生成的字符串将包含对该问题的描述,如下面的例子:

错误或未知的格式标志: %!verb(type=value)

Printf("%d", hi): %!d(string=hi)

太多参数: %!(EXTRA type=value)

Printf("hi", "guys"): hi%!(EXTRA string=guys)

缺少参数: %!verb(MISSING)

Printf("hi%d"): hi %!d(MISSING)

使用非整数提供宽度和精度: %!(BADWIDTH) or %!(BADPREC)

Printf("%*s", 4.5, "hi"): %!(BADWIDTH)hi

Printf("%.*s", 4.5, "hi"): %!(BADPREC)hi

所有的错误都使用"%!"起始,(紧随单字符的格式标志)以括号包围的错误描述结束。

输入

一系列类似的函数读取格式化的文本,生成值。Scan,Scanf和Scanln从os.Stdin读取;Fscan,Fscanf和Fscanln 从特定的io.Reader读取;Sscan,Sscanf和Sscanln 从字符串读取;Scanln,Fscanln和Sscanln在换行时结束读取,并要求数据连续出现;Scanf,Fscanf和Sscanf会读取一整行以匹配格式字符串;其他的函数将换行看着空格。

Scanf, Fscanf, and Sscanf根据格式字符串解析数据,类似于Printf。例如,%x将读取一个十六进制数,%v将读取值的默认表示。

格式行为类似于Printf,但有如下例外:

%p没有提供

%T没有提供

%e %E %f %F %g %G是等价的,都可以读取任何浮点数或者复合数(非复数,指科学计数法表示的带指数的数)

%s 和 %v字符串使用这两个格式读取时会因为空格而结束

不设格式或者使用%v读取整数时,如果前缀为0(八进制)或0x(十六进制),将按对应进制读取。

宽度在输入中被解释(%5s意思是最多从输入读取5个字符赋值给一个字符串),但输入系列函数没有解释精度的语法(木有%5.2f,只有%5f)。

输入系列函数中的格式字符串,所有非空的空白字符(除了换行符之外),无论在输入里还是格式字符串里,都等价于1个空白字符。格式字符串必须匹配输入的文本,如果不匹配将停止读取数据并返回函数已经赋值的参数的数量。

所有的scan系列函数,如果参数包含Scan方法(或者说实现了Scanner接口),该参数将使用该方法读取文本。另外,如果被填写的参数的数量少于提供的参数的数量,将返回一个错误。

所有要被输入的参数都应该是基础类型或者实现了Scanner接口的数据类型的指针。

注意:Fscan等函数可以从输入略过一些字符读取需要的字符并返回,这就意味着一个循环的读取程序可能会跳过输入的部分数据。当数据间没有空白时就会导致出现问题。如果读取这提供给Fscan系列函数ReadRune 方法,这个方法可以用来读取字符。如果读取者还提供了UnreadRune 方法,该方法将被用来保存字符以使成功的调用不会丢失数据。为了给一个没有这些功能的读取者添加这俩方法,使用bufio.NewReader。

目录

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

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)

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

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

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

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 Scan(a ...interface{}) (n int, err error)

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

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

func Sprint(a ...interface{}) string

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

func Sprintln(a ...interface{}) string

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

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

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

type Formatter

type GoStringer

type ScanState

type Scanner

type State

type Stringer

Package files

doc.go format.go print.go scan.go

func Errorf

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

Errorf根据格式字符串和参数表生成一个字符串,该字符串满足error接口。

func Fprint

func Fprint(w io.Writer, a ...interface{}) (n int, err error)

Fprint将所有参数都使用默认的格式写入w。如果相邻两个参数都不是字符串时,会在参数间添加空白。函数返回写入的字节数和任何遇到的错误。

func Fprintf

func Fprintf(w io.Writer, format string, a ...interface{}) (n int, err error)

Fprintf根据格式字符串将参数写入w。函数返回写入的字节数和任何遇到的错误。

func Fprintln

func Fprintln(w io.Writer, a ...interface{}) (n int, err error)

Fprintln将所有参数都使用默认的格式写入w并在最后添加换行。如果相邻两个参数都不是字符串时,会在参数间添加空白。函数返回写入的字节数和任何遇到的错误。

func Fscan

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

Fscan从r读取文本,将连续的空白分割的数据存入连续的参数里。换行视同空白。它返回成功读取的参数的数量。如果少于提供的参数的数量,返回值err将报告原因。

func Fscanf

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

Fscanf从r读取文本,根据格式字符串顺序将数据存入参数中。它返回成功解析并存入的参数的数量。

func Fscanln

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

Fscanln类似Fscanf,但会在换行符中止,并且存入最后一条后时读取位置必须有换行或者结束符。

func Print

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

Print将所有参数都使用默认的格式写入标准输出。如果相邻两个参数都不是字符串时,会在参数间添加空白。函数返回写入的字节数和任何遇到的错误。

func Printf

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

Printf根据格式字符串将参数写入标准输出。函数返回写入的字节数和任何遇到的错误。

func Println

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

Println将所有参数都使用默认的格式写入标准输出并在最后添加换行。如果相邻两个参数均非字符串时,会在参数间添加空白。函数返回写入的字节数和任何遇到的错误。

func Scan

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

Scan从标准输入读取文本,将空白分割的连续数据顺序存入参数里。换行视同空白。它返回成功读取的参数的数量。如果少于提供的参数的数量,返回值err将报告原因。

func Scanf

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

Scanf从标准输入读取文本,根据格式字符串顺序将数据存入参数中。它返回成功解析并存入的参数的数量。

func Scanln

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

Scanln类似Scan,但会在换行符中止,并且存入最后一条后时读取位置必须有换行或者结束符。

func Sprint

func Sprint(a ...interface{}) string

Sprint将所有参数都使用默认的格式写入并生成一个字符串。如果相邻两个参数都不是字符串时,会在参数间添加空白。

func Sprintf

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

Sprintf根据格式字符串将参数写入并返回生成的字符串。

func Sprintln

func Sprintln(a ...interface{}) string

Sprintln将所有参数都使用默认的格式写入并生成一个字符串。如果相邻两个参数都不是字符串时,会在参数间添加空白。字符串最后会添加换行符。

func Sscan

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

Sscan从字符串读取文本,将空白分割的连续数据顺序存入参数里。换行视同空白。它返回成功读取的参数的数量。如果少于提供的参数的数量,返回值err将报告原因。

func Sscanf

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

Scanf从字符串读取文本,根据格式字符串顺序将数据存入参数中。它返回成功解析并存入的参数的数量。

func Sscanln

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

Sscanln类似Sscan,但会在换行符中止,并且存入最后一条后时读取位置必须有换行或者结束符。

type Formatter

type Formatter interface {

Format(f State, c rune)

}

Formatter是一个供用户定制的格式化接口。Format方法的实现可能需要调用Sprintf 或Fprintf(f)等函数来生成输出。

type GoStringer

type GoStringer interface {

GoString() string

}

GoStringer接口由任意包含GoString方法的数据实现,这个方法定义了数据的Go语法格式。GoString方法用来在使用%#v格式标志时输出值。

type ScanState

type ScanState interface {

// ReadRune函数从输入读取下一个Unicode符号。如果在Scanln,Fscanln或Sscanln中调用,本函数会在读取到第一个'\n'或达到最大宽度时返回EOF。

ReadRune() (r rune, size int, err error)

// UnreadRune会让ReadRune的下一次调用返回同一个字符。

UnreadRune() error

// SkipSpace跳过输入的空白。换行被视为空白(Scanln,Fscanln和Sscanln例外,这三个函数里换行符视为EOF)。

SkipSpace()

// Token方法会在skipSpace为真时跳过输入中的空白,并返回一个满足f(c)的Unicode字符。如果f是nil,则使用!unicode.IsSpace(c)(即返回第一个非空格Unicode字符);

// 即是说,本函数只对非空字符起效。换行符视为空白字符(Scanln,Fscanln和Sscanln例外,这三个函数里换行符视为EOF)。

// 返回的切片类型指向共享的数据,该数据可以被下一次Token的调用(使用ScanState接口作为输入调用Scan函数)中或者调用返回的Scan方法时重写。

Token(skipSpace bool, f func(rune) bool) (token []byte, err error)

// Width返回width选项的值以及其是否被设定。

Width() (wid int, ok bool)

// 因为ReadRune用接口实现,Read方法应该永远不被scan程序调用,一个好使的ScanState实现应该保证总是从Read返回错误。

Read(buf []byte) (n int, err error)

}

ScanState是一个交给用户定制的Scanner接口的参数的接口。Scanner接口可能会进行一次一个字符的扫描或者要求ScanState去探测下一个空白分隔的token。

type Scanner

type Scanner interface {

Scan(state ScanState, verb rune) error

}

任何实现了Scan方法的对象都实现了Scanner接口,Scan方法会从输入读取数据并将处理结果存入接受端,接收端必须是有效的指针。Scan方法会被任何Scan、Scanf、Scanln等函数调用,只要对应的参数实现了该方法。

type State

type State interface {

// Write可被调用以发出格式化的输出。

Write(b []byte) (ret int, err error)

// Width返回宽度的值及其是否被设定。

Width() (wid int, ok bool)

// Precision返回精度的值及其是否被设定。

Precision() (prec int, ok bool)

// Flag返回符号(正负号……)的值是否被设定。

Flag(c int) bool

}

State是一个提供给Formatter接口的输出参数的接口。它提供对io.Writer接口的、使用提供的数据对参数格式化后的访问。

type Stringer

type Stringer interface {

String() string

}

Stringer接口被任何实现了String方法的类型自动实现,该方法定义了该类型的“原生”格式。String方法用来输出参数,当使用%s或%v格式时,或者被Print等不使用格式字符串的函数输出时。

原文发布于微信公众号 - Golang语言社区(Golangweb)

原文发表时间:2017-05-24

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏Pythonista

Go 语言常量

在每一个const关键字出现时,被重置为0,然后再下一个const出现之前,每出现一次iota,其所代表的数字会自动增加1。

711
来自专栏Pythonista

Golang之匿名函数和闭包

 基本概念 闭包是可以包含自由(未绑定到特定对象)变量的代码块,这些变量不在这个代码块内或者 任何全局上下文中定义,而是在定义代码块的环境中定义。要执行的代码块...

2841
来自专栏领域驱动设计DDD实战进阶

06-TypeScript中的表达式

TypeScript中提供了箭头表达式,通过箭头表达式可以简化我们的编码。 1.箭头表达式简化匿名函数 在JS中,我们通常使用匿名函数,匿名函数实际上是赋值给一...

2917
来自专栏Golang语言社区

Go语言的fmt包中文教程

Fmt包 import "fmt" 简介 ▾ Package fmt包含有格式化I/O函数,类似于C语言的printf和scanf。格式字符串的规则来源于C但更...

2486
来自专栏Golang语言社区

【JS游戏编程基础】关于js里的this关键字的理解

this关键字在c++,java中都提供了这个关键字,在刚开始学习时觉得有难度,但是只要理解了,用起来就方便多了,下面通过本篇文章给大家详解js里this关键字...

46710
来自专栏锦小年的博客

python学习笔记2.2-print函数以及格式化输出

上一节已经安装好运行环境以及各种库,接下来就要开始正式编程了。与国际接轨,接触一门语言的第一次编程,一定是在屏幕上打印“hello world”。python...

2545
来自专栏微信公众号:Java团长

经典排序算法总结--冒泡、快排、插入、希尔、归并、选择

对纵向排列的关键字序列,按照自下而上的扫描方向对两两相邻的关键字进行比较, 若为逆序(k_j < k_j-1 ),则将两个记录交换位置; 重复上述扫描排序过...

1072
来自专栏Golang语言社区

【Go 语言社区】Golang 语言再谈接口

Go编程提供所谓的接口是另一种数据类型,代表了一组方法签名。结构数据类型实现这些接口对接口的方法签名,并其实现方法具体定义。 Syntax /* define ...

35815
来自专栏每周一脱topic

彻底搞懂golang中的数组和切片slice

通过了解数组array和切片slice的使用和底层原理,可以更透彻的理解他们的使用场景,里面有什么坑。这对我们平时编写程序是极有裨益的,后面我会继续深入,有时间...

1.5K4
来自专栏Golang语言社区

Go语言实现的排列组合问题实例(n个数中取m个)

本文实例讲述了Go语言实现的排列组合问题。分享给大家供大家参考,具体如下: (一)组合问题 组合是一个基本的数学问题,本程序的目标是输出从n个元素中取m个的所有...

3655

扫码关注云+社区

领取腾讯云代金券