詳解 Go 語言中 20 個佔位符！

>>原文地址

學到什麼

1. 什麼是佔位符？
2. 哪些函式支援？
3. 如何使用佔位符？
4. 不同的佔位符的作用？
5. 配合佔位符的幾個標記符號用法？

概念

什麼是佔位符？你就從表面意思理解，就是佔位置，只不過有很多不同種類的位置，而且這個位置不是誰都能坐，是有要求的，在程式層面用於格式化資料。

哪些函式支援

在 Go 語言中，標準包 fmt 有好多格式化的工具函式，函式名末尾通常以 f 結尾，列舉如下：

• fmt.Printf 格式化字串並列印到終端（標準輸出）。
• fmt.Sprintf 格式化字串並返回。
• fmt.Sscanf 從字串中解析佔位符的對應位置資料。
• fmt.Fscanf 從 io.Reader 型別中讀取資料並解析佔位符的對應位置資料，用於讀取檔案、終端（標準輸入）。
• fmt.Fprintf 將格式化的字串資料輸出到 io.Writer 型別中，用於輸出到檔案。
• fmt.Errorf 格式化方式建立一個錯誤型別訊息。

這塊沒有重點展開講解各個函式，只是簡單羅列下，如果還不明白自行查一下，也可以問我。

下來看看本篇的重點...

佔位符使用

佔位符需要使用 % 符號表示，簡單展示一個。

s := fmt.Sprintf("%s真帥", "老苗")
fmt.Println(s)

// 輸出
老苗真帥

%s 標示字串，將"老苗"字串填充到%s 位置。下來看看到底有哪些佔位符？

普通佔位符

先建立一個資料，作為列印的物件。

type Example struct {
    Content string
}

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

1. %v、%+v、%#v

%v：獲取資料的值，如果實現了error 介面，僅表示錯誤訊息。

fmt.Printf("%v", data) 
// 輸出 
{例子}

fmt.Printf("%v", errors.New("我錯了"))
// 輸出
我錯了

%+v：獲取資料的值，如果結構體，會攜帶欄位名。

fmt.Printf("%+v", data)
// 輸出
{Content:例子}

%#v：獲取資料的值，如果是結構體，會攜帶結構體名和欄位名。

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

2. %T

獲取資料型別。

fmt.Printf("%T", data)
// 輸出
main.Example

3. %%

字面上的一個百分號。

fmt.Printf("%%")
// 輸出
%

布林佔位符

%t

true 或 false。

fmt.Printf("%t", true)
// 輸出
true

整數佔位符

1. %b

二進位制。

fmt.Printf("%b", 4)
// 輸出
100

2. %c

Unicode 碼轉字元。

fmt.Printf("%c", 0x82d7)
// 輸出
苗

3. %d、%5d、%-5d、%05d

十進位制整數表示。

fmt.Printf("%d,%d,%d", 10, 010, 0x10)
// 輸出
10,8,16

• 三個資料： 10 十進位制，010 八進位制，0x10 十六進位制

佔位符還可以指定最小寬度，格式如下：

• %5d：最小寬度為 5，右對齊，左邊留白。
• %-5d：左對齊，右邊留白。
• %05d：數字位數不足 5 位時，左邊補零。

例：

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

4. %o、%#o

八進位制表示。

fmt.Printf("%o,%o,%o", 10, 010, 0x10)
// 輸出
12,10,20

在很多開發語言中，0 打頭的數字都表示八進位制。通過 %#o 輸出帶 0 開頭。

fmt.Printf("\n%#o\n", 10)
// 輸出
012

5. %q

同 %c 類似，都是Unicode 碼轉字元，只是結果多了單引號。

fmt.Printf("%q", 0x82d7)
// 輸出
'苗'

漢字對應表：http://www.chi2ko.com/tool/CJK.htm

6. %x、%#x

十六進位制表示，字母形式為小寫 a-f，%#x 輸出帶 0x 開頭。

fmt.Printf("%x, %#x", 13, 13)
// 輸出
d, 0xd

7. %X、%#X

十六進位制表示，字母形式為小寫 A-F，%#X 輸出帶 0X 開頭。

fmt.Printf("%X, %#X", 13, 13)
// 輸出
D, 0XD

8. %U、%#U

%U：轉化為 Unicode 格式規範。

fmt.Printf("%U", 0x82d7)
// 輸出
U+82D7

%#U：轉化為 Unicode 格式並帶上對應的字元。

fmt.Printf("%#U", 0x82d7)
// 輸出
U+82D7 '苗'

浮點數與複數

1. %b

浮點數轉化為 2 的冪的科學計數法。

fmt.Printf("%b", 0.1)
// 輸出
7205759403792794p-56

2. %e、%E

10 的冪的科學計數法。

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 等價。

保留的規則我現在還沒有搞清楚，有時候符合四捨五入，有時候不符合，容我下來研究下，再告訴大家。

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 情況如下：

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

%e 情況如下：

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

%.3g 表示的不是小數保留 3 位，而是隻保留 3 個數字。

fmt.Printf("%.3g", 12.34)
// 輸出
12.3

思考：官網中 %g 和 %G 是有區別的，但我測試下來是等價的，可能我的測試有問題，我給出官網文件，如下：

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

字串與位元組切片

1. %s

字串或位元組切片。

fmt.Printf("%s|%s", "老苗", []byte("嘿嘿嘿"))
// 輸出
老苗|嘿嘿嘿

2. %q

有 Go 語言安全轉義，雙引號包裹。

fmt.Printf("%q", "老苗")
// 輸出
"老苗"

3. %x、%X

十六進位制，%x 小寫字母 a - f，%X 大寫字母 A - F。

fmt.Printf("%x|%X", "苗", "苗")
// 輸出
e88b97|E88B97

指標

%p、%#p

地址，使用十六進位制表示，%p 帶 0x，%#p 不帶。

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

// 輸出
0xc00000a1d0|0xc00000a1e0

其它標記

1. +

列印數值的正負號，對於 %+q，只輸出 ASCII 編碼的字元，如果非 ASCII 編碼，則轉成 Unicode 編碼輸出。

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 列印字串時使用反引號包裹。

fmt.Printf("%#q", "苗")
// 輸出
`苗`

• %#U 列印編碼時，帶上字元，上面已舉例。

4. ' ' 空格

為正負號留出空白位置。

fmt.Printf("|% d|", 2)
// 輸出
| 2|

5. 0

填充前導的 0，對於數字會移到正負號之後，非數字也可使用。

fmt.Printf("%05s", "a")
// 輸出
0000a

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

精度截斷字串

給字串使用精度，用來截斷字串。

fmt.Printf("%.2s", "abc")
// 輸出
ab

總結

佔位符區分大小寫，總共講了 20 個，但佔位符相關的知識點其實還有，我暫時也不想研究了，因為在專案中也很難使用到。

如果有興趣的，前往官網。

地址：https://pkg.go.dev/fmt