log 中的這種用法，你一定見過：

log.SetFlags(log.Ldate | log.Ltime | log.Llongfile)

沒見過的，自我反省下（逃

在 Go 語言的 log 包中，使用“位運(yùn)算相或” (|) 來配置日志的 flag，是為了讓我們靈活地組合多種日志信息輸出選項(xiàng)。，比如是否顯示日期、時(shí)間、微秒、文件名、行號(hào)等。

接下來詳細(xì)解釋這種方法的好處和原理。

1. 什么是 log 包中的 flag

在 log 包中，flag 是用來控制日志輸出格式的一些選項(xiàng)。

每種 flag 都是一個(gè)二進(jìn)制位掩碼，通過不同的掩碼組合，可以控制日志的顯示內(nèi)容。

這些 flag 選項(xiàng)定義如下：

const (
    Ldate         = 1 << iota     // 日期：2009/01/23
    Ltime                         // 時(shí)間：01:23:23
    Lmicroseconds                 // 微秒級(jí)時(shí)間：01:23:23.123123（需要同時(shí)有 Ltime）
    Llongfile                     // 完整文件名和行號(hào)：/a/b/c/d.go:23
    Lshortfile                    // 文件名和行號(hào)：d.go:23（會(huì)覆蓋 Llongfile）
    LUTC                          // 使用 UTC 時(shí)間而非本地時(shí)間
    Lmsgprefix                    // 將“前綴”從行首移動(dòng)到消息之前
    LstdFlags     = Ldate | Ltime // 默認(rèn)值
)

這些常量是通過位移運(yùn)算 1 << iota 定義的，保證每個(gè) flag 只占用一位，且是唯一的。

這樣一來，我們可以用按位或操作 | 來組合多個(gè)選項(xiàng)。

對(duì)應(yīng)的值如下：

const (
	Ldate=1 << iota// iota =0，值為 1 << 0 = 1，二進(jìn)制：00000001，相當(dāng)于2的0次方
	Ltime          // iota = 1，值為 1 << 1 = 2，二進(jìn)制：00000010，相當(dāng)于2的1次方
	Lmicroseconds  // iota = 2，值為 1 << 2 = 4，二進(jìn)制：00000100，相當(dāng)于2的2次方
	Llongfile      // iota = 3，值為 1 << 3 = 8，二進(jìn)制：00001000，相當(dāng)于2的3次方
	Lshortfile     // iota = 4，值為 1 << 4 = 16，二進(jìn)制：00010000，相當(dāng)于2的4次方
	LUTC           // iota = 5，值為 1 << 5 = 32，二進(jìn)制：00100000，相當(dāng)于2的5次方
	Lmsgprefix     // iota = 6，值為 1 << 6 = 64，二進(jìn)制：01000000，相當(dāng)于2的6次方
)

2. 為什么使用按位或 (|) 來組合 flag

按位或 (|) 的好處是可以任意組合選項(xiàng)。因?yàn)槊總€(gè) flag 常量代表一個(gè)獨(dú)特的二進(jìn)制位，所以它們可以通過按位或相加組合在一起，而不會(huì)產(chǎn)生沖突。例如：

• Ltime 的值是 1 << 1，即 0b0010
• Llongfile 的值是 1 << 3，即 0b1000

當(dāng)我們使用 log.SetFlags(Ltime | Llongfile) 時(shí)，相當(dāng)于將 0b0010 | 0b1000 組合成 0b1010，即同時(shí)啟用了時(shí)間和文件名短格式顯示。

通過這種位運(yùn)算方式，可以組合各種 flag 選項(xiàng)，而不必為每種組合重新定義一個(gè)新的常量。

3. 使用按位或組合 flag 的優(yōu)勢(shì)

• 靈活性高：可以自由選擇多個(gè)選項(xiàng)的組合，滿足不同需求，而不必逐一指定每個(gè) flag。
• 可讀性強(qiáng)：按位或組合表達(dá)式簡(jiǎn)單明了，清楚地顯示啟用了哪些功能。
• 高效性：位運(yùn)算本身效率高，計(jì)算量小，而且 flag 常量設(shè)計(jì)成二進(jìn)制掩碼，便于快速組合和解讀。

4. 如何識(shí)別已設(shè)置的flag

當(dāng)我們通過位或組合多個(gè)flag傳遞給log.SetFlags后，log包在輸出日志時(shí)會(huì)檢測(cè)該組合值，并根據(jù)不同的位設(shè)置來確定輸出內(nèi)容。

具體的識(shí)別方式：按位與（&）操作

假設(shè)我們?cè)O(shè)置了以下flag組合：

log.SetFlags(log.Ldate | log.Ltime | log.Llongfile)

傳入的flag組合會(huì)是一個(gè)整型值，log包會(huì)在生成日志時(shí)，通過按位與操作來判斷每個(gè)flag是否存在。具體步驟如下：

• 檢查Ldate：使用按位與操作flags & Ldate，如果結(jié)果不為0，則表示Ldate已被設(shè)置，那么日志將包含日期信息。
• 檢查Ltime：同樣，通過flags & Ltime，非零表示Ltime被設(shè)置，日志中將包含時(shí)間信息。
• 檢查Llongfile：按位檢查flags & Llongfile，通過判斷值來確定是否輸出文件路徑（完整路徑）。

具體來看，假設(shè)我們使用log.Ldate | log.Ltime | log.Llongfile：

• Ldate的值為00000001。
• Ltime的值為00000010。
• Llongfile的值為00001000。

將這些flag組合在一起后的整型值是00001011，它包含了所有的設(shè)置信息。

示例：代碼實(shí)現(xiàn)flag識(shí)別的過程

以log包的實(shí)現(xiàn)原理為例，可以大致模擬flag識(shí)別的過程。假設(shè)flags變量存儲(chǔ)了當(dāng)前的flag設(shè)置值，可以如下判斷是否開啟各個(gè)功能：

package main

import (
    "log"
)

func main() {
    flags := log.Ldate | log.Ltime | log.Llongfile

    if flags&log.Ldate != 0 {
        log.Print("日期已啟用")
    }
    if flags&log.Ltime != 0 {
        log.Print("時(shí)間已啟用")
    }
    if flags&log.Llongfile != 0 {
        log.Print("完整文件路徑已啟用")
    }
}

5. 使用展示

我們來看一個(gè)例子，假設(shè)這段代碼位于 main.go 文件的第 10 行：

package main

import (
    "log"
)

func main() {
    log.SetFlags(log.Ltime | log.Lshortfile)
    log.Println("這是一個(gè)日志消息")
}

如果這段代碼在 2024 年 11 月 3 日 15:04:05 執(zhí)行，日志輸出可能會(huì)是：

15:04:05 main.go:10: 這是一個(gè)日志消息

其中，15:04:05 是時(shí)間，main.go:10 是簡(jiǎn)化的文件名和行號(hào)。

6. 總結(jié)

使用按位或操作符 | 來配置日志 flag，可以讓我們靈活地組合日志的不同顯示選項(xiàng)，方便地自定義輸出格式。這種方式不僅簡(jiǎn)化了代碼，還提高了日志配置的靈活性和可讀性。

到此這篇關(guān)于Go中l(wèi)og包異或組合配置妙用詳解的文章就介紹到這了,更多相關(guān)Go log包異或組合內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論