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

------------------------------------------------------------