Golang学习 - errors 包

Go 语言使用 error 类型来返回函数执行过程中遇到的错误，如果返回的 error 值为 nil，则表示未遇到错误，否则 error 会返回一个字符串，用于说明遇到了什么错误。

其实 error 只是一个接口，定义如下：

type error interface {
    Error() string
}

你可以用任何类型去实现它（只要添加一个 Error() 方法即可），也就是说，error 可以是任何类型，这意味着，函数返回的 error 值实际可以包含任意信息，不一定是字符串（当然字符串是必须的）。

error 不一定表示一个错误，它可以表示任何信息，比如 io 包中就用 error 类型的 io.EOF 表示数据读取结束，而不是遇到了什么错误。再比如 path/filepath 包中用 error 类型的 filepath.SkipDir 表示跳过当前目录，继续遍历下一个目录，而不是遇到了什么错误。

errors 包实现了一个最简单的 error 类型，只包含一个字符串，它可以记录大多数情况下遇到的错误信息。errors 包的用法也很简单，只有一个 New 函数，用于生成一个最简单的 error 对象：

// 将字符串 text 包装成一个 error 对象返回
func New(text string) error

// 示例
func SomeFunc() error {
    if 遇到错误 {
        return errors.New("遇到了某某错误")
    }
    return nil
}

如果你的程序需要记录更多的错误信息，比如时间、数值等信息，可以声明一个自定义的 error 类型。

// 示例
package main

import (
    "fmt"
    "time"
)

type myError struct {
    err   string
    time  time.Time
    count int
}

func (m *myError) Error() string {
    return fmt.Sprintf("%s %d 次。时间：%v", m.err, m.count, m.time)
}

func newErr(s string, i int) *myError {
    return &myError{
        err:   s,
        time:  time.Now(),
        count: i,
    }
}

var count int

func SomeFunc() error {
    if true {
        count++
        return newErr("遇到某某情况", count)
    }
    return nil
}

func main() {
    for i := 0; i < 5; i++ {
        if err := SomeFunc(); err != nil {
            fmt.Println(err)
        }
    }
}