README
¶
log
Logger 单个日志
std 是 Logger 的实例，默认是单个日志
Documentation
¶
Overview ¶
Package log implements a simple logging package. It defines a type, Logger, with methods for formatting output. It also has a predefined 'standard' Logger accessible through helper functions Print[f|ln], Fatal[f|ln], and Panic[f|ln], which are easier to use than creating a Logger manually. That logger writes to standard error and prints the date and time of each logged message. Every log message is output on a separate line: if the message being printed does not end in a newline, the logger will add one. The Fatal functions call os.Exit(1) after writing the log message. The Panic functions call panic after writing the log message.
Index ¶
- Constants
- func ContentPrefix() string
- func Debug(format string, v ...interface{})
- func Debugf(format string, v ...interface{})
- func Debugln(v ...interface{})
- func Error(format string, v ...interface{})
- func Errorf(format string, v ...interface{})
- func Errorln(v ...interface{})
- func Fatal(v ...interface{})
- func Fatalf(format string, v ...interface{})
- func Fatalln(v ...interface{})
- func Flags() int
- func IncrOneCallDepth()
- func Info(format string, v ...interface{})
- func Infof(format string, v ...interface{})
- func Infoln(v ...interface{})
- func Output(calldepth int, s string) error
- func Panic(v ...interface{})
- func Panicf(format string, v ...interface{})
- func Panicln(v ...interface{})
- func Prefix() string
- func Print(v ...interface{})
- func Printf(format string, v ...interface{})
- func Println(v ...interface{})
- func SetCallDepth(callDepth int)
- func SetContentPrefix(prefix string)
- func SetFlags(flag int)
- func SetIsTerminal(isTerminal int)
- func SetLevel(level Level)
- func SetOutput(w io.Writer)
- func SetPrefix(prefix string)
- func SetSuffix(suffix string)
- func Suffix() string
- func Verbose(format string, v ...interface{})
- func Verbosef(format string, v ...interface{})
- func Verboseln(v ...interface{})
- func Warn(format string, v ...interface{})
- func Warnf(format string, v ...interface{})
- func Warnln(v ...interface{})
- type Level
- type Logger
- func (l *Logger) Clone() *Logger
- func (l *Logger) ContentPrefix() string
- func (l *Logger) Debug(format string, v ...interface{})
- func (l *Logger) Debugf(format string, v ...interface{})
- func (l *Logger) Debugln(v ...interface{})
- func (l *Logger) Error(format string, v ...interface{})
- func (l *Logger) Errorf(format string, v ...interface{})
- func (l *Logger) Errorln(v ...interface{})
- func (l *Logger) Fatal(v ...interface{})
- func (l *Logger) Fatalf(format string, v ...interface{})
- func (l *Logger) Fatalln(v ...interface{})
- func (l *Logger) Flags() int
- func (l *Logger) IncrOneCallDepth()
- func (l *Logger) Info(format string, v ...interface{})
- func (l *Logger) Infof(format string, v ...interface{})
- func (l *Logger) Infoln(v ...interface{})
- func (l *Logger) Level() Level
- func (l *Logger) Output(calldepth int, s string, level Level) error
- func (l *Logger) Panic(v ...interface{})
- func (l *Logger) Panicf(format string, v ...interface{})
- func (l *Logger) Panicln(v ...interface{})
- func (l *Logger) Prefix() string
- func (l *Logger) Print(v ...interface{})
- func (l *Logger) Printf(format string, v ...interface{})
- func (l *Logger) Println(v ...interface{})
- func (l *Logger) SetCallDepth(callDepth int)
- func (l *Logger) SetContentPrefix(prefix string)
- func (l *Logger) SetFlags(flag int)
- func (l *Logger) SetIsTerminal(isTerminal int)
- func (l *Logger) SetLevel(level Level)
- func (l *Logger) SetOutput(w io.Writer)
- func (l *Logger) SetPrefix(prefix string)
- func (l *Logger) SetSuffix(suffix string)
- func (l *Logger) Suffix() string
- func (l *Logger) Verbose(format string, v ...interface{})
- func (l *Logger) Verbosef(format string, v ...interface{})
- func (l *Logger) Verboseln(v ...interface{})
- func (l *Logger) Warn(format string, v ...interface{})
- func (l *Logger) Warnf(format string, v ...interface{})
- func (l *Logger) Warnln(v ...interface{})
- type MultiLogger
Constants ¶
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 LLevel LstdFlags = Ldate | Ltime // initial values for the standard logger )
These flags define which text to prefix to each log entry generated by the Logger. Bits are or'ed together to control what's printed. There is no control over the order they appear (the order listed here) or the format they present (as described in the comments). The prefix is followed by a colon only when Llongfile or Lshortfile is specified. For example, flags Ldate | Ltime (or LstdFlags) produce,
2009/01/23 01:23:23 message
while flags Ldate | Ltime | Lmicroseconds | Llongfile produce,
2009/01/23 01:23:23.123123 /a/b/c/d.go:23: message
const ( // IsTerminal output to a terminal. IsTerminal = 0 // NotTerminal output to file. NotTerminal = 1 )
const MaxContextLen = 66
MaxContextLen max content len. If log has suffix, and log body len is not bigger than MaxContextLen, I will use blank to fill the log body till MaxContextLen.
Variables ¶
This section is empty.
Functions ¶
func ContentPrefix ¶
func ContentPrefix() string
ContentPrefix returns the output content prefix for the standard logger.
func Debugf ¶
func Debugf(format string, v ...interface{})
Debugf calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Printf.
func Errorf ¶
func Errorf(format string, v ...interface{})
Errorf calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Printf.
func Fatal ¶
func Fatal(v ...interface{})
Fatal is equivalent to Print() followed by a call to os.Exit(1).
func Fatalf ¶
func Fatalf(format string, v ...interface{})
Fatalf is equivalent to Printf() followed by a call to os.Exit(1).
func Fatalln ¶
func Fatalln(v ...interface{})
Fatalln is equivalent to Println() followed by a call to os.Exit(1).
func Infof ¶
func Infof(format string, v ...interface{})
Infof calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Printf.
func Output ¶
Output writes the output for a logging event. The string s contains the text to print after the prefix specified by the flags of the Logger. A newline is appended if the last character of s is not already a newline. Calldepth is the count of the number of frames to skip when computing the file name and line number if Llongfile or Lshortfile is set; a value of 1 will print the details for the caller of Output.
func Panic ¶
func Panic(v ...interface{})
Panic is equivalent to Print() followed by a call to panic().
func Panicf ¶
func Panicf(format string, v ...interface{})
Panicf is equivalent to Printf() followed by a call to panic().
func Panicln ¶
func Panicln(v ...interface{})
Panicln is equivalent to Println() followed by a call to panic().
func Print ¶
func Print(v ...interface{})
Print calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Print.
func Printf ¶
func Printf(format string, v ...interface{})
Printf calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Printf.
func Println ¶
func Println(v ...interface{})
Println calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Println.
func SetCallDepth ¶
func SetCallDepth(callDepth int)
SetCallDepth set whether log output is terminal
func SetContentPrefix ¶
func SetContentPrefix(prefix string)
SetContentPrefix sets the output content prefix for the standard logger.
func SetIsTerminal ¶
func SetIsTerminal(isTerminal int)
SetIsTerminal set whether log output is terminal
func SetPrefix ¶
func SetPrefix(prefix string)
SetPrefix sets the output prefix for the standard logger.
func SetSuffix ¶
func SetSuffix(suffix string)
SetSuffix sets the output suffix for the standard logger.
func Verbosef ¶
func Verbosef(format string, v ...interface{})
Verbosef calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Printf.
Types ¶
type Logger ¶
type Logger struct {
// contains filtered or unexported fields
}
A Logger represents an active logging object that generates lines of output to an io.Writer. Each logging operation makes a single call to the Writer's Write method. A Logger can be used simultaneously from multiple goroutines; it guarantees to serialize access to the Writer.
func DefaultLog ¶
func DefaultLog() *Logger
func New ¶
func New(out io.Writer, prefix string, suffix string, flag int, level Level, isTerminal int) *Logger
New creates a new Logger. The out variable sets the destination to which log data will be written. The prefix appears at the beginning of each generated log line. The flag argument defines the logging properties.
func NewDefaultLog ¶
func NewDefaultLog() *Logger
func (*Logger) ContentPrefix ¶
ContentPrefix returns the output content prefix for the logger.
func (*Logger) Debugf ¶
Debugf calls l.Output to print to the logger. Arguments are handled in the manner of fmt.Printf.
func (*Logger) Errorf ¶
Errorf calls l.Output to print to the logger. Arguments are handled in the manner of fmt.Printf.
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) Fatalln ¶
func (l *Logger) Fatalln(v ...interface{})
Fatalln is equivalent to l.Println() followed by a call to os.Exit(1).
func (*Logger) IncrOneCallDepth ¶
func (l *Logger) IncrOneCallDepth()
IncrOneCallDepth call depth add one
func (*Logger) Infof ¶
Infof calls l.Output to print to the logger. Arguments are handled in the manner of fmt.Printf.
func (*Logger) Output ¶
Output writes the output for a logging event. The string s contains the text to print after the prefix specified by the flags of the Logger. A newline is appended if the last character of s is not already a newline. Calldepth is used to recover the PC and is provided for generality, although at the moment on all pre-defined paths it will be 2.
func (*Logger) Panic ¶
func (l *Logger) Panic(v ...interface{})
Panic is equivalent to l.Print() followed by a call to panic().
func (*Logger) Panicln ¶
func (l *Logger) Panicln(v ...interface{})
Panicln is equivalent to l.Println() followed by a call to panic().
func (*Logger) Print ¶
func (l *Logger) Print(v ...interface{})
Print calls l.Output to print to the logger. Arguments are handled in the manner of fmt.Print.
func (*Logger) Printf ¶
Printf calls l.Output to print to the logger. Arguments are handled in the manner of fmt.Printf.
func (*Logger) Println ¶
func (l *Logger) Println(v ...interface{})
Println calls l.Output to print to the logger. Arguments are handled in the manner of fmt.Println.
func (*Logger) SetCallDepth ¶
SetCallDepth set whether log output is terminal
func (*Logger) SetContentPrefix ¶
SetContentPrefix sets the output content prefix for the logger.
func (*Logger) SetIsTerminal ¶
SetIsTerminal set whether log output is terminal
func (*Logger) Verbosef ¶
Verbosef calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Printf.
type MultiLogger ¶
type MultiLogger struct {
// contains filtered or unexported fields
}
MultiLogger use to output log to console and file at the same time.
Source Files
Directories