go语言标准库(包) log 日志包文档

Package log

import “log”

log包实现了简单的日志记录，它定义了Logger类型，其中包含格式化输出的方法。 它还有一个预定义的“标准”Logger，可以通过辅助函数Print[f|ln]，Fatal[f|ln]和Panic[f|ln]访问，它们比手动创建Logger更容易使用(Logger你可以理解为"日志记录器")。该记录器写入标准错误(stderr)并打印每个记录消息的日期和时间。每条日志消息都在单独的行中输出：如果正在打印的消息未以换行符结尾，则记录器将添加一条消息。 Fatal函数在写入日志消息后调用os.Exit(1)， Panic函数在写入日志消息后调用panic。

---

• 常量Constants
• 输出致命错误Fatal
• 格式化输出致命错误Fatalf
• 格式化输出致命错误并换行Fatalln
• 获取当前日志记录器的标志Flags
• 为日志事件写入输出Output
• 输出并调用恐慌Panic
• 格式化输出并调用恐慌Panicf
• 输出并换行后调用恐慌Panicln
• 获取标准记录的前缀Prefix
• 日志打印Print
• 格式化打印Printf
• 格式化打印并换行Println
• 为标准记录器设置记录标志SetFlags
• 为日志记录器设置I/O输出SetOutput
• 为日志记录器设置前缀SetPrefix
• Type Logger(Logger类型)
  • 创建Logger对象New
  • Logger对象调用写入致命日志Fatal
  • Logger对象调用写入格式化致命日志Fatalf
  • Logger对象调用写入致命日志带换行Fatalln
  • 获取Logger对象的标志Flags
  • Logger对象输出Output
  • Logger对象输出恐慌日志panic
  • Logger对象输出格式化恐慌panicf
  • Logger对象输出带换行的恐慌panicln
  • 获取Logger对象前缀
  • Logger对象打印日志Print
  • Logger对象格式化打印日志Printf
  • Logger对象打印带换行日志Println
  • 设置Logger对象的输出标志SetFlags
  • 设置Logger对象的输出目的地SetOutput
  • 设置Logger对象的输出前缀SetPrefix
  • 获取Logger对象的输出目的地Writer

---

常量Constants

这些标志定义了Logger生成的每个日志条目的前缀文本。 比特位是“或”在一起来控制打印的内容。 无法控制它们出现的顺序（此处列出的顺序）或它们呈现的格式（如注释中所述）。 仅当指定Llongfile或Lshortfile时，前缀后跟冒号。 例如，标志Ldate | Ltime(或LstdFlags)产生，

2009/01/23 01:23:23 message

而标志 Ldate|Ltime|Lmicroseconds|Llongfile生产，(日期|时间|微秒|输出文件路径级行号)

2009/01/23 01:23:23.123123 /a/b/c/d.go:23: message

const (
		// 本地时区格式：yyyy/MM/dd
        Ldate         = 1 << iota
        // 本地时间格式：HH:mm:ss
        Ltime
        // 微妙解析度：HH:mm:ss.ms
        Lmicroseconds
        // 完整的文件路径/文件名以及行号: /a/b/c/d.go:23
        Llongfile
        // 仅文件名元素以及行号： d.go:23（使用此标志将覆盖Llongfile标志）
        Lshortfile
        // 如果设置了Ldate或Ltime, 将使用UTC而不是本地时区
        LUTC
        // 标准日志记录器的初始值（仅日期及时间）
        LstdFlags     = Ldate | Ltime
)

输出致命错误Fatal

func Fatal(v ...interface{
   })

Fatal等效于先使用Print()输出信息，然后再调用os.Exit(1)输出stderr，错误代码1，并退出程序。

---

格式化输出致命错误Fatalf

func Fatalf(format string, v ...interface{
   })

Fatalf等效于先使用Printf()输出信息，然后再调用os.Exit(1)输出stderr，错误代码1，并退出程序。

---

格式化输出致命错误并换行Fatalln

func Fatalln(v ...interface{