Go语言软件包fmt使用与C语言的printf和scanf类似的功能,实现了格式化I / O函数。格式“动词”派生自C,但更简单。
普通占位符
占位符 | 说明 | 举例 | 输出 |
---|---|---|---|
%v | 相应值的默认格式 | name := “张三” fmt.Printf(“%v”, name) | 张三 |
%+v | 打印结构体时,会添加字段名 | Printf(“%+v”, people) | {Name:zhangsan} |
%#v | 相应值的Go语法表示 | Printf(“#v”, people) | main.Human{Name:“zhangsan”} |
%T | 相应值的类型的Go语法表示 | Printf(“%T”, people) | main.Human |
%% | 字面上的百分号,并非值的占位符 | Printf(“%%”) | % |
布尔值
占位符 | 说明 | 举例 | 输出 |
---|---|---|---|
%t | true 或 false | Printf(“%t”, true) | true |
整数
占位符 | 说明 | 举例 | 输出 |
---|---|---|---|
%b | 二进制表示 | Printf(“%b”, 5) | 101 |
%c | 对应的Unicode代码点表示的字符 | Printf(“%c”, 0x4E2D) | 中 |
%d | 十进制表示 | Printf(“%d”, 0x12) | 18 |
%o | 八进制表示 | Printf(“%d”, 10) | 12 |
%q | 单引号围绕的字符字面值,由Go语法安全地转义 | Printf(“%q”, 0x4E2D) | ‘中’ |
%x | 十六进制表示,字母形式为小写 a-f | Printf(“%x”, 13) | d |
%X | 十六进制表示,字母形式为大写 A-F | Printf(“%x”, 13) | D |
%U | Unicode格式:U+1234,等同于 “U +%04X” | Printf(“%U”, 0x4E2D) | U+4E2D |
浮点数和复数的组成部分(实部和虚部)
占位符 | 说明 | 举例 | 输出 |
---|---|---|---|
%b | 无小数部分的,指数为二的幂的科学计数法,与 strconv.FormatFloat 的 ‘b’ 转换格式一致。 | 例如 -123456p-78 | |
%e | 科学计数法,例如 -1234.456e+78 | Printf(“%e”, 10.2) | 1.020000e+01 |
%E | 科学计数法,例如 -1234.456E+78 | Printf(“%e”, 10.2) | 1.020000E+01 |
%f | 有小数点而无指数,例如 123.456 | Printf(“%f”, 10.2) | 10.200000 |
%F | %F是%f 的同义词 | ||
%g | 根据情况选择 %e 或 %f 以产生更紧凑的(无末尾的0) | Printf(“%g”, 10.20) | 10.2 |
%G | 根据情况选择 %E 或 %f 以产生更紧凑的(无末尾的0) | Printf(“%G”, 10.20+2i) | 10.2+2i |
字符串和字节片(与这些动词等效地处理)
占位符 | 说明 | 举例 | 输出 |
---|---|---|---|
%s | 输出字符串表示(string类型或[]byte) | Printf(“%s”, []byte(“Go语言”)) | Go语言 |
%q | 双引号围绕的字符串,由Go语法安全地转义 | Printf(“%q”, “Go语言”) | “Go语言” |
%x | 十六进制,小写字母,每字节两个字符 | Printf(“%x”, “golang”) | 676f6c616e67 |
%X | 十六进制,大写字母,每字节两个字符 | Printf(“%X”, “golang”) | 676F6C616E67 |
片
以基数16表示的第0个元素的%p地址,开头为0x
指针
%p以16为基础的表示法,前导0x
%b,%d,%o,%x和%X动词也可以与指针配合使用,
完全格式化该值,就好像它是整数一样。
占位符 | 说明 | 举例 | 输出 |
---|---|---|---|
%p | 十六进制表示,前缀 0x | Printf(“%p”, &people) | 0x4f57f0 |
其它标志
占位符 | 说明 | 举例 | 输出 |
---|---|---|---|
+ | 总打印数值的正负号;对于%q(%+q)保证只输出ASCII编码的字符。 | Printf(“%+q”, “中文”) | “\u4e2d\u6587” |
- | 在右侧而非左侧填充空格(左对齐该区域) | ||
# | 备用格式:为八进制添加前导 0(%#o)。 为十六进制添加前导 0x(%#x)或 0X(%#X),为 %p(%#p)去掉前导 0x;为十六进制添加前导 0x(%#x)或 0X(%#X),为 %p(%#p)去掉前导 0x;如果可能的话,%q(%#q)会打印原始 (即反引号围绕的)字符串;如果可能的话,%q(%#q)会打印原始 (即反引号围绕的)字符串; 如果是可打印字符,%U(%#U)会写出该字符的 ,Unicode 编码形式(如字符 x 会被打印成 U+0078 ‘x’)。 | Printf(“%#U”, ‘中’) | U+4E2D |
’ ’ | (空格)为数值中省略的正负号留出空白(% d);以十六进制(% x, % X)打印字符串或切片时,在字节之间用空格隔开。 | ||
0 | 填充前导的0而非空格;对于数字,这会将填充移到正负号之后 |
标志被不需要它们的动词忽略。例如,没有替代的十进制格式,因此%#d和%d的行为相同。
%v的默认格式
类型 | 格式 |
---|---|
布尔: | %t |
int,int8等: | %d |
uint,uint8等: | %d,%#x(如果使用%#v打印) |
float32,complex64等: | %g |
字符串: | %s |
chan: | %p |
指针: | %p |
golang没有 ‘%u’ 点位符,若整数为无符号类型,默认就会被打印成无符号的。
宽度与精度
宽度由动词前的可选十进制数字指定。如果不存在,则宽度是表示值所必需的。
精度在(可选)宽度之后指定一个句点,后跟一个十进制数字。如果不存在句点,则使用默认精度。没有以下数字的句点指定精度为零。例如:
%f 默认宽度,默认精度
%9f 宽度9,默认精度
%.2f 默认宽度,精度2
%9.2f 宽度9,精度2
%9.f 宽度9,精度0
宽度和精度以Unicode代码点(即,符文)为单位进行度量。(这与C的printf不同,后者始终以字节为单位。)两个标志中的一个或两个都可以用字符’*'替换,从而使它们的值从下一个操作数获得(在格式化之前)。必须是int类型。
对于大多数值,width是要输出的最小符文数,必要时用空格填充格式化的表单。
但是,对于字符串,字节片和字节数组,精度会限制要格式化的输入的长度(而不是输出的大小),并在必要时将其截断。通常,它以符文为单位进行度量,但是对于这些类型,使用%x或%X格式进行格式化时,将以字节为单位进行度量。
对于浮点值,width设置字段的最小宽度,而precision设置小数点后的位数(如果适用),除了%g /%G精度设置最大有效位数(除去零位) 。
例如,给定12.345,格式%6.3f打印12.345,而%.3g打印12.3。%e,%f和%#g的默认精度为6;对于%g,它是唯一标识该值所需的最少位数。
对于复数,宽度和精度分别应用于两个分量,并且将结果括在括号中,因此将%f应用于1.2 + 3.4i生成(1.200000 + 3.400000i)。
对于每个类似于Printf的函数,还有一个Print函数,该函数不采用任何格式,等效于为每个操作数说%v。Println的另一个变体在操作数之间插入空格,并添加换行符。
无论动词如何,如果操作数是接口值,那么将使用内部具体值,而不是接口本身。例如:
var i interface {} = 23
fmt.Printf(“%v \ n”,i)
打印结果: 23
除非使用动词%T和%p进行打印,否则特殊的格式化注意事项适用于实现某些接口的操作数。按申请顺序:
- 如果操作数是reflect.Value,则将操作数替换为其所持有的具体值,并使用下一条规则继续打印。
- 如果一个操作数实现了Formatter接口,它将被调用。Formatter提供了对格式的精细控制。
- 如果%v动词与#标志(%#v)一起使用,并且操作数实现GoStringer接口,则将调用该接口。
如果格式(对于Println等,隐式为%v)对字符串(%s%q%v%x%X)有效,则以下两个规则适用: - 如果操作数实现错误接口,则将调用Error方法将对象转换为字符串,然后将根据动词的要求对其进行格式化(如果有)。
- 如果操作数实现String()字符串方法,则将调用该方法将对象转换为字符串,然后根据动词的要求对其进行格式化(如果有)。
对于切片和结构之类的复合操作数,格式递归地应用于每个操作数的元素,而不是整个操作数。因此%q将引用字符串切片的每个元素,而%6.2f将控制浮点数组的每个元素的格式。
但是,在打印带有字符串状动词(%s%q%x%X)的字节片时,将其与字符串等同地视为一个项。