log

package
v0.0.0-...-ade9fc0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 10, 2020 License: MIT Imports: 7 Imported by: 3

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

View Source 
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
View Source 
const (
	// IsTerminal output to a terminal.
	IsTerminal = 0

	// NotTerminal output to file.
	NotTerminal = 1
)
View Source 
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 Debug 

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

Debug is the same as Debugf

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 Debugln 

func Debugln(v ...interface{})

Debugln debug level log

func Error 

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

Error is the same as Errorf

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 Errorln 

func Errorln(v ...interface{})

Errorln debug level log

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 Flags 

func Flags() int

Flags returns the output flags for the standard logger.

func IncrOneCallDepth 

func IncrOneCallDepth()

IncrOneCallDepth call depth add one

func Info 

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

Info is the same as Infof

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 Infoln 

func Infoln(v ...interface{})

Infoln debug level log

func Output 

func Output(calldepth int, s string) error

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 Prefix 

func Prefix() string

Prefix returns the output prefix for the standard logger.

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 SetFlags 

func SetFlags(flag int)

SetFlags sets the output flags for the standard logger.

func SetIsTerminal 

func SetIsTerminal(isTerminal int)

SetIsTerminal set whether log output is terminal

func SetLevel 

func SetLevel(level Level)

SetLevel sets the log level.

func SetOutput 

func SetOutput(w io.Writer)

SetOutput sets the output destination for the standard logger.

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 Suffix 

func Suffix() string

Suffix returns the output suffix for the standard logger.

func Verbose 

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

Verbose is the same as Verbosef

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.

func Verboseln 

func Verboseln(v ...interface{})

Verboseln verbose level log

func Warn 

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

Warn is the same as Warnf

func Warnf 

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

Warnf calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Printf.

func Warnln 

func Warnln(v ...interface{})

Warnln debug level log

Types

type Level 

type Level uint32

Level type 

const (
	// PanicLevel level
	PanicLevel Level = iota

	// FatalLevel level
	FatalLevel

	// ErrorLevel level
	ErrorLevel

	// WarnLevel level
	WarnLevel

	// InfoLevel level
	InfoLevel

	// DebugLevel level
	DebugLevel

	// VerboseLevel level
	VerboseLevel
)

func GetLevel 

func GetLevel() Level

Level returns the log level.

func NameToLevel 

func NameToLevel(name string) Level

NameToLevel get log level from level name.

func (Level) Color 

func (level Level) Color() int

Color get level color

func (Level) String 

func (level Level) String() string

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 Clone 

func Clone() *Logger

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) Clone 

func (l *Logger) Clone() *Logger

func (*Logger) ContentPrefix 

func (l *Logger) ContentPrefix() string

ContentPrefix returns the output content prefix for the logger.

func (*Logger) Debug 

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

Debug is the same as Debugf

func (*Logger) Debugf 

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

Debugf calls l.Output to print to the logger. Arguments are handled in the manner of fmt.Printf.

func (*Logger) Debugln 

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

Debugln debug level log

func (*Logger) Error 

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

Error is the same as Errorf

func (*Logger) Errorf 

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

Errorf calls l.Output to print to the logger. Arguments are handled in the manner of fmt.Printf.

func (*Logger) Errorln 

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

Errorln debug level log

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 is equivalent to l.Printf() 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) Flags 

func (l *Logger) Flags() int

Flags returns the output flags for the logger.

func (*Logger) IncrOneCallDepth 

func (l *Logger) IncrOneCallDepth()

IncrOneCallDepth call depth add one

func (*Logger) Info 

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

Info is the same as Infof

func (*Logger) Infof 

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

Infof calls l.Output to print to the logger. Arguments are handled in the manner of fmt.Printf.

func (*Logger) Infoln 

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

Infoln debug level log

func (*Logger) Level 

func (l *Logger) Level() Level

Level returns the log level.

func (*Logger) Output 

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

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) Panicf 

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

Panicf is equivalent to l.Printf() 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) Prefix 

func (l *Logger) Prefix() string

Prefix returns the output prefix for the logger.

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 

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

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 

func (l *Logger) SetCallDepth(callDepth int)

SetCallDepth set whether log output is terminal

func (*Logger) SetContentPrefix 

func (l *Logger) SetContentPrefix(prefix string)

SetContentPrefix sets the output content prefix for the logger.

func (*Logger) SetFlags 

func (l *Logger) SetFlags(flag int)

SetFlags sets the output flags for the logger.

func (*Logger) SetIsTerminal 

func (l *Logger) SetIsTerminal(isTerminal int)

SetIsTerminal set whether log output is terminal

func (*Logger) SetLevel 

func (l *Logger) SetLevel(level Level)

SetLevel sets the log level.

func (*Logger) SetOutput 

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

SetOutput sets the output destination for the logger.

func (*Logger) SetPrefix 

func (l *Logger) SetPrefix(prefix string)

SetPrefix sets the output prefix for the logger.

func (*Logger) SetSuffix 

func (l *Logger) SetSuffix(suffix string)

SetSuffix sets the output suffix for the logger.

func (*Logger) Suffix 

func (l *Logger) Suffix() string

Suffix returns the output suffix for the logger.

func (*Logger) Verbose 

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

Verbose is the same as Verbosef

func (*Logger) Verbosef 

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

Verbosef calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Printf.

func (*Logger) Verboseln 

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

Verboseln verbose level log

func (*Logger) Warn 

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

Warn is the same as Warnf

func (*Logger) Warnf 

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

Warnf calls l.Output to print to the logger. Arguments are handled in the manner of fmt.Printf.

func (*Logger) Warnln 

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

Warnln debug level log

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

View all Source files

Directories

Path Synopsis
example
clone
cloneMultiLog
mwriter
newLog
newMultiLog
plainLog
stdLog
stdMultiLog

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.