log
logger
log包定义了Logger类型,该类型提供了一些格式化输出的方法。本包也提供了一个预定义的“标准”logger,可以通过调用函数Print系列(Print|Printf|Println)、Fatal系列(Fatal|Fatalf|Fatalln)、和Panic系列(Panic|Panicf|Panicln)来使用,比自行创建一个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(...)}
创建logger
log标准库中还提供了一个创建新logger对象的构造函数–New,支持我们创建自己的logger示例。New函数的签名如下:
func New(out io.Writer, prefix string, flag int) *Logger
New创建一个Logger对象。其中,参数out设置日志信息写入的目的地。参数prefix会添加到生成的每一条日志前面。参数flag定义日志的属性(时间、文件等等)。
配置logger
默认情况下的logger只会提供日志的时间信息,但是很多情况下我们希望得到更多信息,比如记录该日志的文件名和行号等。log标准库中为我们提供了定制这些设置的方法。
log标准库中的Flags函数会返回标准logger的输出配置,而SetFlags函数用来设置标准logger的输出配置。
func Flags() int func SetFlags(flag int)
flag选项
const ( // 控制输出日志信息的细节,不能控制输出的顺序和格式。 // 输出的日志在每一项后会有一个冒号分隔:例如2009/01/23 01:23:23.123123 /a/b/c/d.go:23: message Ldate = 1 << iota // 日期:2009/01/23 Ltime // 时间:01:23:23 Lmicroseconds // 微秒级别的时间:01:23:23.123123(用于增强Ltime位) Llongfile // 文件全路径名+行号: /a/b/c/d.go:23 Lshortfile // 文件名+行号:d.go:23(会覆盖掉Llongfile) LUTC // 使用UTC时间 LstdFlags = Ldate | Ltime // 标准logger的初始值 )
下面我们在记录日志之前先设置一下标准logger的输出选项如下:
func main() { log.SetFlags(log.Llongfile | log.Lmicroseconds | log.Ldate) log.Println("这是一条很普通的日志。") }
log标准库中还提供了关于日志信息前缀的两个方法:
func Prefix() string func SetPrefix(prefix string)
其中Prefix函数用来查看标准logger的输出前缀,SetPrefix函数用来设置输出前缀。
log导出函数
log 导出函数基于预定义的 std 变量 var std = New(os.Stderr, "", LstdFlags) 实现。
- func Flags() int // 获取预定义“标准”日志输出属性
- func Prefix() string // 获取预定义“标准”日志前缀
- func SetOutput(w io.Writer) // 设置预定义“标准”日志输出位置
- func Print(v ...interface{}) // 打印一条标准日志
strconv
strconv包实现了基本数据类型与其字符串表示的转换,主要有以下常用函数: Atoi()、Itoa()、parse系列、format系列、append系列。
String和int类型转换
Atoi()
Atoi()函数用于将字符串类型的整数转换为int类型,函数签名如下。
func Atoi(s string) (i int, err error) strconv.Atoi(str string)(int, error): 把一个字符串转成整数
通过函数签名可以看出 Atoi() 函数有两个返回值, i 为转换成功的整型, err 在转换成功是为空转换失败时为相应的错误信息。如果传入的字符串参数无法转换为int类型,就会返回错误。
Itoa()
Itoa()函数用于将int类型数据转换为对应的字符串表示,具体的函数签名如下。
func Itoa(i int) string
其他
其他类型转换成为string类型除了用strconv包,还可以用fmt.Sprintf函数:
package main import ( "fmt") func main() { s2 := fmt.Sprintf("%d", 456) println(s2)
Parse
Parse类函数用于转换字符串为给定类型的值:ParseBool()、ParseFloat()、ParseInt()、ParseUint()。
Parse 系列函数都有两个返回值,第一个返回值是转换后的值,第二个返回值为转化失败的错误信息。
ParseBool()
func ParseBool(str string) (value bool, err error)
返回字符串表示的bool值。它接受1、0、t、f、T、F、true、false、True、False、TRUE、FALSE;否则返回错误。
ParseInt()
func ParseInt(s string, base int, bitSize int) (i int64, err error)
返回字符串表示的整数值,接受正负号。
base指定进制(2到36),如果base为0,则会从字符串前置判断,”0x”是16进制,”0”是8进制,否则是10进制;
bitSize指定结果必须能无溢出赋值的整数类型,0、8、16、32、64 分别代表 int、int8、int16、int32、int64;
返回的err是*NumErr类型的,如果语法有误,err.Error = ErrSyntax;如果结果超出类型范围err.Error = ErrRange。
ParseUnit()
func ParseUint(s string, base int, bitSize int) (n uint64, err error)
ParseUint类似ParseInt但不接受正负号,用于无符号整型。
ParseFloat()
func ParseFloat(s string, bitSize int) (f float64, err error)
解析一个表示浮点数的字符串并返回其值。
如果s合乎语法规则,函数会返回最为接近s表示值的一个浮点数(使用IEEE754规范舍入)。
bitSize指定了期望的接收类型,32是float32(返回值可以不改变精确值的赋值给float32),64是float64;
返回值err是*NumErr类型的,语法有误的,err.Error=ErrSyntax;结果超出表示范围的,返回值f为±Inf,err.Error= ErrRange。
Format
Format系列函数实现了将给定类型数据格式化为string类型数据的功能。
FormatBool()
func FormatBool(b bool) string
根据b的值返回”true”或”false”。
FormatInt()
func FormatInt(i int64, base int) string
返回i的base进制的字符串表示。base 必须在2到36之间,结果中会使用小写字母’a’到’z’表示大于10的数字。
FormatUint()
func FormatUint(i uint64, base int) string
是FormatInt的无符号整数版本。
FormatFloat()
func FormatFloat(f float64, fmt byte, prec, bitSize int) string
函数将浮点数表示为字符串并返回。
bitSize表示f的来源类型(32:float32、64:float64),会据此进行舍入。
Append
Append 系列函数用于将指定类型转换成字符串后追加到一个切片中,其中包含 AppendBool() 、 AppendFloat() 、 AppendInt() 、 AppendUint() 。
Append 系列函数和 Format 系列函数的使用方法类似,只不过是将转换后的结果追加到一个切片中。
isPrint()
func IsPrint(r rune) bool
返回一个字符是否是可打印的,和unicode.IsPrint一样,r必须是:字母(广义)、数字、标点、符号、ASCII空格。
CanBackquote()
func CanBackquote(s string) bool
返回字符串s是否可以不被修改的表示为一个单行的、没有空格和tab之外控制字符的反引号字符串。