Go 有一個預先定義的 error 接口類型
~~~
type error interface {
Error() string
}
~~~
錯誤值用來表示異常狀態;我們可以在?[5.2 節](https://github.com/Unknwon/the-way-to-go_ZH_CN/blob/master/eBook/05.2.md)中看到它的標準用法。處理文件操作的例子可以在 12 章找到;我們將在 15 章看到網絡操作的例子。errors 包中有一個 errorString 結構體實現了 error 接口。當程序處于錯誤狀態時可以用?`os.Exit(1)`來中止運行。
## [](https://github.com/Unknwon/the-way-to-go_ZH_CN/blob/master/eBook/13.1.md#1311-定義錯誤)13.1.1 定義錯誤
任何時候當你需要一個新的錯誤類型,都可以用?`errors`(必須先 import)包的?`errors.New`?函數接收合適的錯誤信息來創建,像下面這樣:
~~~
err := errors.New(“math - square root of negative number”)
~~~
在示例 13.1 中你可以看到一個簡單的用例:
示例 13.1?[errors.go](https://github.com/Unknwon/the-way-to-go_ZH_CN/blob/master/eBook/examples/chapter_13/errors.go):
~~~
// errors.go
package main
import (
"errors"
"fmt"
)
var errNotFound error = errors.New("Not found error")
func main() {
fmt.Printf("error: %v", errNotFound)
}
// error: Not found error
~~~
可以把它用于計算平方根函數的參數測試:
~~~
func Sqrt(f float64) (float64, error) {
if f < 0 {
return 0, errors.New (“math - square root of negative number”)
}
// implementation of Sqrt
}
~~~
你可以像下面這樣調用 Sqrt 函數:
~~~
if f, err := Sqrt(-1); err != nil {
fmt.Printf(“Error: %s\n”, err)
}
~~~
由于?`fmt.Printf`?會自動調用?`String()`?方法 (參見?[10.7 節](https://github.com/Unknwon/the-way-to-go_ZH_CN/blob/master/eBook/10.7.md)),所以錯誤信息 “Error: math - square root of negative number” 會打印出來。通常(錯誤信息)都會有像 “Error:” 這樣的前綴,所以你的錯誤信息不要以大寫字母開頭。
在大部分情況下自定義錯誤結構類型很有意義的,可以包含除了(低層級的)錯誤信息以外的其它有用信息,例如,正在進行的操作(打開文件等),全路徑或名字。看下面例子中 os.Open 操作觸發的 PathError 錯誤:
~~~
// PathError records an error and the operation and file path that caused it.
type PathError struct {
Op string // “open”, “unlink”, etc.
Path string // The associated file.
Err error // Returned by the system call.
}
func (e *PathError) String() string {
return e.Op + “ ” + e.Path + “: “+ e.Err.Error()
}
~~~
如果有不同錯誤條件可能發生,那么對實際的錯誤使用類型斷言或類型判斷(type-switch)是很有用的,并且可以根據錯誤場景做一些補救和恢復操作。
~~~
// err != nil
if e, ok := err.(*os.PathError); ok {
// remedy situation
}
~~~
或:
~~~
switch err := err.(type) {
case ParseError:
PrintParseError(err)
case PathError:
PrintPathError(err)
...
default:
fmt.Printf(“Not a special error, just %s\n”, err)
}
~~~
作為第二個例子考慮用 json 包的情況。當 json.Decode 在解析 JSON 文檔發生語法錯誤時,指定返回一個 SyntaxError 類型的錯誤:
~~~
type SyntaxError struct {
msg string // description of error
// error occurred after reading Offset bytes, from which line and columnnr can be obtained
Offset int64
}
func (e *SyntaxError) String() string { return e.msg }
~~~
在調用代碼中你可以像這樣用類型斷言測試錯誤是不是上面的類型:
~~~
if serr, ok := err.(*json.SyntaxError); ok {
line, col := findLine(f, serr.Offset)
return fmt.Errorf(“%s:%d:%d: %v”, f.Name(), line, col, err)
}
~~~
包也可以用額外的方法(methods)定義特定的錯誤,比如 net.Errot:
~~~
package net
type Error interface {
Timeout() bool // Is the error a timeout?
Temporary() bool // Is the error temporary?
}
~~~
在?[15.1 節](https://github.com/Unknwon/the-way-to-go_ZH_CN/blob/master/eBook/15.1.md)?我們可以看到怎么使用它。
正如你所看到的一樣,所有的例子都遵循同一種命名規范:錯誤類型以 “Error” 結尾,錯誤變量以 “err” 或 “Err” 開頭。
syscall 是低階外部包,用來提供系統基本調用的原始接口。它們返回整數的錯誤碼;類型 syscall.Errno 實現了 Error 接口。
大部分 syscall 函數都返回一個結果和可能的錯誤,比如:
~~~
r, err := syscall.Open(name, mode, perm)
if err != 0 {
fmt.Println(err.Error())
}
~~~
os 包也提供了一套像 os.EINAL 這樣的標準錯誤,它們基于 syscall 錯誤:
~~~
var (
EPERM Error = Errno(syscall.EPERM)
ENOENT Error = Errno(syscall.ENOENT)
ESRCH Error = Errno(syscall.ESRCH)
EINTR Error = Errno(syscall.EINTR)
EIO Error = Errno(syscall.EIO)
...
)
~~~
## [](https://github.com/Unknwon/the-way-to-go_ZH_CN/blob/master/eBook/13.1.md#1312-用-fmt-創建錯誤對象)13.1.2 用 fmt 創建錯誤對象
通常你想要返回包含錯誤參數的更有信息量的字符串,例如:可以用?`fmt.Errorf()`?來實現:它和 fmt.Printf() 完全一樣,接收有一個或多個格式占位符的格式化字符串和相應數量的占位變量。和打印信息不同的是它用信息生成錯誤對象。
比如在前面的平方根例子中使用:
~~~
if f < 0 {
return 0, fmt.Errorf(“math: square root of negative number %g”, f)
}
~~~
第二個例子:從命令行讀取輸入時,如果加了 help 標志,我們可以用有用的信息產生一個錯誤:
~~~
if len(os.Args) > 1 && (os.Args[1] == “-h” || os.Args[1] == “--help”) {
err = fmt.Errorf(“usage: %s infile.txt outfile.txt”, filepath.Base(os.Args[0]))
return
}
~~~
- 前言
- 第一部分:學習 Go 語言
- 第1章:Go 語言的起源,發展與普及
- 1.1 起源與發展
- 1.2 語言的主要特性與發展的環境和影響因素
- 第2章:安裝與運行環境
- 2.1 平臺與架構
- 2.2 Go 環境變量
- 2.3 在 Linux 上安裝 Go
- 2.4 在 Mac OS X 上安裝 Go
- 2.5 在 Windows 上安裝 Go
- 2.6 安裝目錄清單
- 2.7 Go 運行時(runtime)
- 2.8 Go 解釋器
- 第3章:編輯器、集成開發環境與其它工具
- 3.1 Go 開發環境的基本要求
- 3.2 編輯器和集成開發環境
- 3.3 調試器
- 3.4 構建并運行 Go 程序
- 3.5 格式化代碼
- 3.6 生成代碼文檔
- 3.7 其它工具
- 3.8 Go 性能說明
- 3.9 與其它語言進行交互
- 第二部分:語言的核心結構與技術
- 第4章:基本結構和基本數據類型
- 4.1 文件名、關鍵字與標識符
- 4.2 Go 程序的基本結構和要素
- 4.3 常量
- 4.4 變量
- 4.5 基本類型和運算符
- 4.6 字符串
- 4.7 strings 和 strconv 包
- 4.8 時間和日期
- 4.9 指針
- 第5章:控制結構
- 5.1 if-else 結構
- 5.2 測試多返回值函數的錯誤
- 5.3 switch 結構
- 5.4 for 結構
- 5.5 Break 與 continue
- 5.6 標簽與 goto
- 第6章:函數(function)
- 6.1 介紹
- 6.2 函數參數與返回值
- 6.3 傳遞變長參數
- 6.4 defer 和追蹤
- 6.5 內置函數
- 6.6 遞歸函數
- 6.7 將函數作為參數
- 6.8 閉包
- 6.9 應用閉包:將函數作為返回值
- 6.10 使用閉包調試
- 6.11 計算函數執行時間
- 6.12 通過內存緩存來提升性能
- 第7章:數組與切片
- 7.1 聲明和初始化
- 7.2 切片
- 7.3 For-range 結構
- 7.4 切片重組(reslice)
- 7.5 切片的復制與追加
- 7.6 字符串、數組和切片的應用
- 第8章:Map
- 8.1 聲明、初始化和 make
- 8.2 測試鍵值對是否存在及刪除元素
- 8.3 for-range 的配套用法
- 8.4 map 類型的切片
- 8.5 map 的排序
- 8.6 將 map 的鍵值對調
- 第9章:包(package)
- 9.1 標準庫概述
- 9.2 regexp 包
- 9.3 鎖和 sync 包
- 9.4 精密計算和 big 包
- 9.5 自定義包和可見性
- 9.6 為自定義包使用 godoc
- 9.7 使用 go install 安裝自定義包
- 9.8 自定義包的目錄結構、go install 和 go test
- 9.9 通過 Git 打包和安裝
- 9.10 Go 的外部包和項目
- 9.11 在 Go 程序中使用外部庫
- 第10章:結構(struct)與方法(method)
- 10.1 結構體定義
- 10.2 使用工廠方法創建結構體實例
- 10.3 使用自定義包中的結構體
- 10.4 帶標簽的結構體
- 10.5 匿名字段和內嵌結構體
- 10.6 方法
- 10.8 垃圾回收和 SetFinalizer
- 第11章:接口(interface)與反射(reflection)
- 11.1 接口是什么
- 11.2 接口嵌套接口
- 11.3 類型斷言:如何檢測和轉換接口變量的類型
- 11.4 類型判斷:type-switch
- 11.5 測試一個值是否實現了某個接口
- 11.6 使用方法集與接口
- 11.7 第一個例子:使用 Sorter 接口排序
- 11.8 第二個例子:讀和寫
- 11.9 空接口
- 11.10 反射包
- 第三部分:Go 高級編程
- 第12章 讀寫數據
- 12.1 讀取用戶的輸入
- 12.2 文件讀寫
- 12.3 文件拷貝
- 12.4 從命令行讀取參數
- 12.5 用buffer讀取文件
- 12.6 用切片讀寫文件
- 12.7 用 defer 關閉文件
- 12.8 使用接口的實際例子:fmt.Fprintf
- 12.9 Json 數據格式
- 12.10 XML 數據格式
- 12.11 用 Gob 傳輸數據
- 12.12 Go 中的密碼學
- 第13章 錯誤處理與測試
- 13.1 錯誤處理
- 13.2 運行時異常和 panic
- 13.3 從 panic 中恢復(Recover)
- 13.4 自定義包中的錯誤處理和 panicking
- 13.5 一種用閉包處理錯誤的模式
- 13.6 啟動外部命令和程序
- 13.7 Go 中的單元測試和基準測試
- 13.8 測試的具體例子
- 13.9 用(測試數據)表驅動測試
- 13.10 性能調試:分析并優化 Go 程序
- 第14章:協程(goroutine)與通道(channel)
- 14.1 并發、并行和協程
- 14.2 使用通道進行協程間通信
- 14.3 協程同步:關閉通道-對阻塞的通道進行測試
- 14.4 使用 select 切換協程
- 14.5 通道,超時和計時器(Ticker)
- 14.6 協程和恢復(recover)
- 第15章:網絡、模版與網頁應用
- 15.1 tcp服務器
- 15.2 一個簡單的web服務器
- 15.3 訪問并讀取頁面數據
- 15.4 寫一個簡單的網頁應用
- 第四部分:實際應用
- 第16章:常見的陷阱與錯誤
- 16.1 誤用短聲明導致變量覆蓋
- 16.2 誤用字符串
- 16.3 發生錯誤時使用defer關閉一個文件
- 16.5 不需要將一個指向切片的指針傳遞給函數
- 16.6 使用指針指向接口類型
- 16.7 使用值類型時誤用指針
- 16.8 誤用協程和通道
- 16.9 閉包和協程的使用
- 16.10 糟糕的錯誤處理
- 第17章:模式
- 17.1 關于逗號ok模式
- 第18章:出于性能考慮的實用代碼片段
- 18.1 字符串
- 18.2 數組和切片
- 18.3 映射
- 18.4 結構體
- 18.5 接口
- 18.6 函數
- 18.7 文件
- 18.8 協程(goroutine)與通道(channel)
- 18.9 網絡和網頁應用
- 18.10 其他
- 18.11 出于性能考慮的最佳實踐和建議
- 附錄