Package log

Overview ▾

程序包日志实现了一个简单的日志记录程序包. 它定义了Logger类型,并带有格式化输出的方法. 它还具有可通过帮助函数Print [f | ln],Fatal [f | ln]和Panic [f | ln]访问的预定义​​"标准"记录器,比手动创建记录器更容易使用. 该记录器将写入标准错误,并打印每个记录的消息的日期和时间. 每条日志消息都在单独的行上输出:如果要打印的消息未以换行符结尾,则记录器将添加一条. 致命函数在写入日志消息后调用os.Exit(1). 紧急情况功能会在写入日志消息后调用紧急情况.

Constants

这些标志定义在记录器生成的每个日志条目之前添加哪些文本. 将位组合在一起以控制所打印的内容. 无法控制它们的显示顺序(此处列出的顺序)或它们显示的格式(如注释中所述). 仅当指定Llongfile或Lshortfile时,前缀后才带有冒号. 例如,标记Ldate | Ltime(或LstdFlags)产生,

2009/01/23 01:23:23 message

同时标记Ldate | Ltime | 微秒| Llongfile产生,

2009/01/23 01:23:23.123123 /a/b/c/d.go:23: message
const (
    Ldate         = 1 << iota     // the date in the local time zone: 2009/01/23
    Ltime                         // the time in the local time zone: 01:23:23
    Lmicroseconds                 // microsecond resolution: 01:23:23.123123.  assumes Ltime.
    Llongfile                     // full file name and line number: /a/b/c/d.go:23
    Lshortfile                    // final file name element and line number: d.go:23. overrides Llongfile
    LUTC                          // if Ldate or Ltime is set, use UTC rather than the local time zone
    LstdFlags     = Ldate | Ltime // initial values for the standard logger
)

func Fatal

func Fatal(v ...interface{})

致命等同于Print(),然后调用os.Exit(1).

func Fatalf

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

Fatalf等效于Printf(),然后调用os.Exit(1).

func Fatalln

func Fatalln(v ...interface{})

Fatalln等效于Println(),然后调用os.Exit(1).

func Flags

func Flags() int

标志返回标准记录器的输出标志.

func Output 1.5

func Output(calldepth int, s string) error

输出写入日志事件的输出. 字符串s包含要在Logger的标志指定的前缀之后打印的文本. 如果s的最后一个字符还不是换行符,则会附加一个换行符. Calldepth是在设置Llongfile或Lshortfile的情况下计算文件名和行号时要跳过的帧数的计数; 值1将为Output的调用者打印详细信息.

func Panic

func Panic(v ...interface{})

Panic等效于Print(),然后调用panic().

func Panicf

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

Panicf等效于Printf(),然后调用panic().

func Panicln

func Panicln(v ...interface{})

Panicln等效于Println(),然后调用panic().

func Prefix

func Prefix() string

前缀返回标准记录器的输出前缀.

func Print

func Print(v ...interface{})

打印呼叫输出以打印到标准记录仪. 参数以fmt.Print的方式处理.

func Printf

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

Printf调用Output打印到标准记录器. 以fmt.Printf的方式处理参数.

func Println

func Println(v ...interface{})

Println调用Output打印到标准记录器. 以fmt.Println的方式处理参数.

func SetFlags

func SetFlags(flag int)

SetFlags设置标准记录器的输出标志.

func SetOutput

func SetOutput(w io.Writer)

SetOutput设置标准记录器的输出目标.

func SetPrefix

func SetPrefix(prefix string)

SetPrefix设置标准记录器的输出前缀.

func Writer 1.13

func Writer() io.Writer

Writer返回标准记录器的输出目标.

type Logger

记录器表示一个活动的记录对象,该对象生成到io.Writer的输出行. 每个记录操作都会调用Writer的Write方法. 一个Logger可以从多个goroutines中同时使用. 它保证序列化对Writer的访问.

type Logger struct {
    // contains filtered or unexported fields
}

Example

logger: example_test.go:19: Hello, log file!

func New

func New(out io.Writer, prefix string, flag int) *Logger

新建将创建一个新的记录器. out变量设置将日志数据写入的目的地. 该前缀出现在每个生成的日志行的开头. flag参数定义日志记录属性.

func (*Logger) Fatal

func (l *Logger) Fatal(v ...interface{})

Fatal is equivalent to l.Print() followed by a call to os.Exit(1).

func (*Logger) Fatalf

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

Fatalf等效于l.Printf(),然后调用os.Exit(1).

func (*Logger) Fatalln

func (l *Logger) Fatalln(v ...interface{})

Fatalln等效于l.Println(),然后调用os.Exit(1).

func (*Logger) Flags

func (l *Logger) Flags() int

标志返回记录器的输出标志.

func (*Logger) Output

func (l *Logger) Output(calldepth int, s string) error

输出写入日志事件的输出. 字符串s包含要在Logger的标志指定的前缀之后打印的文本. 如果s的最后一个字符还不是换行符,则会附加一个换行符. Calldepth用于恢复PC并用于一般性目的,尽管目前在所有预定义路径上为2.

Example

INFO: example_test.go:36: Hello world

func (*Logger) Panic

func (l *Logger) Panic(v ...interface{})

Panic等效于l.Print(),然后调用panic().

func (*Logger) Panicf

func (l *Logger) Panicf(format string, v ...interface{})

Panicf等效于l.Printf(),然后调用panic().

func (*Logger) Panicln

func (l *Logger) Panicln(v ...interface{})

Panicln等效于l.Println(),然后调用panic().

func (*Logger) Prefix

func (l *Logger) Prefix() string

前缀返回记录器的输出前缀.

func (*Logger) Print

func (l *Logger) Print(v ...interface{})

打印呼叫l.输出以打印到记录仪. 参数以fmt.Print的方式处理.

func (*Logger) Printf

func (l *Logger) Printf(format string, v ...interface{})

Printf调用l.Output打印到记录器. 以fmt.Printf的方式处理参数.

func (*Logger) Println

func (l *Logger) Println(v ...interface{})

Println调用l.Output打印到记录器. 以fmt.Println的方式处理参数.

func (*Logger) SetFlags

func (l *Logger) SetFlags(flag int)

SetFlags设置记录器的输出标志.

func (*Logger) SetOutput 1.5

func (l *Logger) SetOutput(w io.Writer)

SetOutput设置记录器的输出目标.

func (*Logger) SetPrefix

func (l *Logger) SetPrefix(prefix string)

SetPrefix设置记录器的输出前缀.

func (*Logger) Writer 1.12

func (l *Logger) Writer() io.Writer

Writer返回记录器的输出目标.

Subdirectories

Name Synopsis
..
syslog 软件包syslog为系统日志服务提供了一个简单的界面.

by  ICOPY.SITE