Go 语言中常用的占位符

概念

什么是占位符?你就从表面意思理解,就是占位置,只不过有很多不同种类的位置,而且这个位置不是谁都能坐,是有要求的,在程序层面用于格式化数据。

哪些函数支持

在 Go 语言中,标准包 fmt 有好多格式化的工具函数,函数名末尾通常以 f 结尾,列举如下:

  • fmt.Printf 格式化字符串并打印到终端(标准输出)。
  • fmt.Sprintf 格式化字符串并返回。
  • fmt.Sscanf 从字符串中解析占位符的对应位置数据。
  • fmt.Fscanf 从 io.Reader 类型中读取数据并解析占位符的对应位置数据,用于读取文件、终端(标准输入)。
  • fmt.Fprintf 将格式化的字符串数据输出到 io.Writer 类型中,用于输出到文件。
  • fmt.Errorf 格式化方式创建一个错误类型消息。

这块没有重点展开讲解各个函数,只是简单罗列下,如果还不明白自行查一下。

下来看看本篇的重点…

占位符使用

占位符需要使用 % 符号表示,简单展示一个。

1
2
3
4
5
s := fmt.Sprintf("%s学习", "努力")
fmt.Println(s)

// 输出
努力学习

%s 标示字符串,将”努力”字符串填充到%s 位置。下来看看到底有哪些占位符?

普通占位符

先创建一个数据,作为打印的对象。

1
2
3
4
5
type Example struct {
Content string
}

var data = Example{Content: "例子"}

1、%v、%+v、%#v
%v:获取数据的值,如果实现了error 接口,仅表示错误消息。

1
2
3
4
5
6
7
fmt.Printf("%v", data) 
// 输出
{例子}

fmt.Printf("%v", errors.New("我错了"))
// 输出
我错了

%+v:获取数据的值,如果结构体,会携带字段名。

1
2
3
fmt.Printf("%+v", data)
// 输出
{Content:例子}

%#v:获取数据的值,如果是结构体,会携带结构体名和字段名。

1
2
3
fmt.Printf("%#v", data)
// 输出
main.Example{Content:"例子"}

2、%T
获取数据类型。

1
2
3
fmt.Printf("%T", data)
// 输出
main.Example

3、%%
字面上的一个百分号。

1
2
3
fmt.Printf("%%")
// 输出
%

布尔占位符
%t
true 或 false。

1
2
3
fmt.Printf("%t", true)
// 输出
true

整数占位符

1、%b
二进制。

1
2
3
fmt.Printf("%b", 4)
// 输出
100

2、%c

Unicode 码转字符。

1
2
3
fmt.Printf("%c", 0x82d7)
// 输出

3、%d、%5d、%-5d、%05d
十进制整数表示。

1
2
3
fmt.Printf("%d,%d,%d", 10, 010, 0x10)
// 输出
10,8,16

三个数据: 10 十进制,010 八进制,0x10 十六进制

占位符还可以指定最小宽度,格式如下:

  • %5d:最小宽度为 5,右对齐,左边留白。
  • %-5d:左对齐,右边留白。
  • %05d:数字位数不足 5 位时,左边补零。

例:

1
2
3
fmt.Printf("|%5d|%-5d|%05d|", 1, 1, 1)
// 输出
| 1|1 |00001|

4、%o、%#o
八进制表示。

1
2
3
fmt.Printf("%o,%o,%o", 10, 010, 0x10)
// 输出
12,10,20

在很多开发语言中,0 打头的数字都表示八进制。通过 %#o 输出带 0 开头。

1
2
3
fmt.Printf("\n%#o\n", 10)
// 输出
012

5、%q
同 %c 类似,都是Unicode 码转字符,只是结果多了单引号。

1
2
3
fmt.Printf("%q", 0x82d7)
// 输出
'苗'

汉字对应表:字体编辑用中日韩汉字Unicode编码表 - 编著:中韩翻译网 金圣镇

6、%x、%#x
十六进制表示,字母形式为小写 a-f,%#x 输出带 0x 开头。

1
2
3
fmt.Printf("%x, %#x", 13, 13)
// 输出
d, 0xd

7、%X、%#X
十六进制表示,字母形式为小写 A-F,%#X 输出带 0X 开头。

1
2
3
fmt.Printf("%X, %#X", 13, 13)
// 输出
D, 0XD

8、%U、%#U
%U:转化为 Unicode 格式规范。

1
2
3
fmt.Printf("%U", 0x82d7)
// 输出
U+82D7

%#U:转化为 Unicode 格式并带上对应的字符。

1
2
3
fmt.Printf("%#U", 0x82d7)
// 输出
U+82D7 '苗'

浮点数与复数

1、%b
浮点数转化为 2 的幂的科学计数法。

1
2
3
fmt.Printf("%b", 0.1)
// 输出
7205759403792794p-56

2、%e、%E
10 的幂的科学计数法。

1
2
3
4
5
6
7
fmt.Printf("%e", 10.2)
// 输出
1.020000e+01

fmt.Printf("%E", 10.2)
// 输出
1.020000E+01

区别:%e 与 %E 输出时的大小写之分。

3、%f、%.2f 等等
浮点数,%.2f 表示保留 2 位小数,%f 默认保留 6 位,%f 与 %F 等价。

1
2
3
4
5
6
7
fmt.Printf("%f", 10.2)
// 输出
10.200000

fmt.Printf("%.2f|%.2f", 10.232, 10.235)
// 输出
10.23|10.23

也可以加入最小宽度,如下:

  • %9.2f 宽度最小为 9,包含小数位在内,精度为 2。
  • %9.f 或 %9f 宽度最小为 9。

4、%g、%.3g
根据情况选择 %e 或 %f ,但末尾去除 0。

%f 情况如下:

1
2
3
fmt.Printf("%g|%g", 10.20, 1.200000+3.400000i)
// 输出
10.2|(1.2+3.4i)

%e 情况如下:

1
2
3
fmt.Printf("%g|%g", 2e2, 2E2)
// 输出
200|200

%.3g 表示的不是小数保留 3 位,而是只保留 3 个数字。

1
2
3
fmt.Printf("%.3g", 12.34)
// 输出
12.3

思考:官网中 %g 和 %G 是有区别的,但我测试下来是等价的,可能我的测试有问题,我给出官网文档,如下:

1
2
%g    %e for large exponents, %f otherwise. Precision is discussed below.
%G %E for large exponents, %F otherwise

字符串与字节切片

1、%s
字符串或字节切片。

1
2
3
fmt.Printf("%s|%s", "好好", []byte("学习"))
// 输出
好好|学习

2、%q
有 Go 语言安全转义,双引号包裹。

1
2
3
fmt.Printf("%q", "学习")
// 输出
"学习"

3、%x、%X
十六进制,%x 小写字母 a - f,%X 大写字母 A - F。

1
2
3
fmt.Printf("%x|%X", "苗", "苗")
// 输出
e88b97|E88B97

指针

%p、%#p
地址,使用十六进制表示,%p 带 0x,%#p 不带。

1
2
3
4
5
6
num := 2
s := []int{1, 2}
fmt.Printf("%p|%p", &num, s)

// 输出
0xc00000a1d0|0xc00000a1e0

其它标记

1、+
打印数值的正负号,对于 %+q,只输出 ASCII 编码的字符,如果非 ASCII 编码,则转成 Unicode 编码输出。

1
2
3
4
5
6
7
fmt.Printf("%+d|%+d", 2, -2)
// 输出
+2|-2

fmt.Printf("%+q|%+q", "miao","苗")
// 输出
"miao"|"\u82d7"

2、-
在右侧填充空格,这块就不举例了,使用如 %-5d ,浮点%-9.2f 也支持,其它占位符大家可以有兴趣自行实验。

3、

  • 为八进制添加前导 0,上面已举例。
  • 为十六进制添加前导 0x 或 0X,上面已举例。
  • 为 %#p去掉 0x。
  • %+q 打印字符串时使用反引号包裹。
1
2
3
fmt.Printf("%#q", "苗")
// 输出
`苗`
  • %#U 打印编码时,带上字符,上面已举例。

4、’ ‘ 空格
为正负号留出空白位置。

1
2
3
fmt.Printf("|% d|", 2)
// 输出
| 2|

5、0
填充前导的 0,对于数字会移到正负号之后,非数字也可使用。

1
2
3
4
5
6
7
fmt.Printf("%05s", "a")
// 输出
0000a

fmt.Printf("%+05d", 1)
// 输出
+0001

精度截断字符串
给字符串使用精度,用来截断字符串。

1
2
3
fmt.Printf("%.2s", "abc")
// 输出
ab

总结
占位符区分大小写,总共讲了 20 个,但占位符相关的知识点其实还有,我暂时也不想研究了,因为在项目中也很难使用到。

-------------本文结束感谢您的阅读-------------