Go 标准库介绍六: log
2017-03-30 07:51
344 查看
Go 标准库介绍六: log
原文链接 http://ironxu.com/775
本文介绍Go 标准库 log 的常用导出函数,结构体及方法。
log 包实现了简单的日志服务,log 包定义了Logger类型,该类型提供了一些格式化输出的方法。本包也提供了一个预定义的“标准”Logger,可以通过辅助函数Print[f|ln]、Fatal[f|ln]和Panic[f|ln]访问,比手工创建一个Logger对象更容易使用。Logger会打印每条日志信息的日期、时间,默认输出到标准错误。Fatal系列函数会在写入日志信息后调用os.Exit(1)。Panic系列函数会在写入日志信息后调用panic。
Logger 类型表示一个记录日志的对象,它会生成一行行的输出写入一个
pkg/log
可以关注我的微博了解更多信息: @刚刚小码农
原文链接 http://ironxu.com/775
本文介绍Go 标准库 log 的常用导出函数,结构体及方法。
import log
log 包实现了简单的日志服务,log 包定义了Logger类型,该类型提供了一些格式化输出的方法。本包也提供了一个预定义的“标准”Logger,可以通过辅助函数Print[f|ln]、Fatal[f|ln]和Panic[f|ln]访问,比手工创建一个Logger对象更容易使用。Logger会打印每条日志信息的日期、时间,默认输出到标准错误。Fatal系列函数会在写入日志信息后调用os.Exit(1)。Panic系列函数会在写入日志信息后调用panic。
1. Logger 结构体
Logger 结构体定义:type Logger struct { mu sync.Mutex // ensures atomic writes; protects the following fields prefix string // prefix to write at beginning of each line flag int // properties out io.Writer // destination for output buf []byte // for accumulating text to write }
Logger 类型表示一个记录日志的对象,它会生成一行行的输出写入一个
io.Writer接口。每一条日志操作会调用一次
io.Writer接口的
Write方法。Logger 类型的对象可以被多个线程安全的同时使用,它会保证对
io.Writer接口的顺序访问。
func New(out io.Writer, prefix string, flag int) *Logger// 创建一个Logger, out设置日志信息写入的目的地, prefix 添加到生成的每一条日志前面, flag定义日志的属性
func (l *Logger) Flags() int// Flags返回logger的输出选项
func (l *Logger) SetFlags(flag int)// SetFlags设置logger的输出选项
func (l *Logger) Prefix() string// Prefix返回logger的输出前缀
func (l *Logger) SetPrefix(prefix string)// SSetPrefix设置logger的输出前缀
func (l *Logger) Output(calldepth int, s string) error// 输出一条日志
func (l *Logger) Printf(format string, v ...interface{})// 将生成的格式化字符串输出到out
func (l *Logger) Fatal(v ...interface{})// Fatal等价于{l.Print(v…); os.Exit(1)}
func (l *Logger) Panic(v ...interface{})// Panic等价于{l.Print(v…); panic(…)}
2. log 导出函数
log 导出函数基于预定义的std变量
var std = New(os.Stderr, "", LstdFlags)实现。
func Flags() int// 获取预定义“标准”日志输出属性
func Prefix() string// 获取预定义“标准”日志前缀
func SetOutput(w io.Writer)// 设置预定义“标准”日志输出位置
func Print(v ...interface{})// 打印一条标准日志
3. 代码示例
$GOPATH/src/github.com/ironxu/go_note/library/log/log.go源码如下:
// go 标准库 log package main import ( "fmt" "log" "os" ) func main() { logger := log.New(os.Stdout, "a log:", log.Lshortfile) logger.SetFlags(log.Llongfile) fmt.Println(logger.Flags()) // 8 logger.SetPrefix("debug:") fmt.Println(logger.Prefix()) // debug: logger.Print("hello, log file") err := logger.Output(2, "world") fmt.Println(err) logger.Printf("%v\t%v", "hello", "go") // logger.Fatal("fatal log") // logger.Panic("Panic log") // 使用预定义日志类型 fmt.Println(log.Flags()) // 3 fmt.Println(log.Prefix()) // '' log.Print("hello predefine log") // 2017/03/04 16:34:27 hello predefine log }
参考
pkg/log 中文pkg/log
可以关注我的微博了解更多信息: @刚刚小码农
相关文章推荐
- Go 标准库介绍一: strings
- Go 标准库介绍四: path
- 优秀 Go 项目介绍: uniqush/log
- Go 标准库介绍五: io
- Go 标准库介绍二: time
- Go 标准库介绍三: os
- 标准库中iostream的全面介绍
- Go 普通LOG输出
- Go语言学习笔记 --- 入门介绍
- go语言介绍
- /var/log/目录介绍
- 二十二、标准库类型vector的使用、vector介绍、vector构造和初始化、vector常用成员函数
- Go语言的代码组织结构详细介绍
- Git中log、diff命令介绍
- dalvikvm gc相关log介绍
- Golang 标准库log的实现
- C++的iostream标准库介绍
- Android第一行代码阅读笔记001 主要文件夹介绍、activity的注册、资源引用的方法、Log日志打印的使用
- svn show log: want to go offline
- Go语言常用命令介绍