Go の例: エラー

Go では、明示的で別の戻り値を介してエラーを伝えるのが慣習です。これは、Java や Ruby のような言語で使用される例外や、C で使用される単一の結果/エラー値のオーバーロード型とは対照的です。Go の方法では、どの関数がエラーを返し、他のエラーのないタスクに使用されるのと同じ言語構造を使用してエラーを処理するのが容易です。詳細については、errors パッケージのドキュメントとこのブログの投稿を参照してください。
	`package main`
	`import ( "errors" "fmt" )`
慣習により、エラーは最後の戻り値で、タイプは、組み込みインターフェイスである `error` です。	`func f(arg int) (int, error) { if arg == 42 {`
`errors.New` は、指定されたエラーメッセージを持つ基本的な `error` 値を構築します。	`return -1, errors.New("can't work with 42") }`
エラーの位置に `nil` 値がある場合、エラーが発生しなかったことを示します。	`return arg + 3, nil }`
セントリーエラーは特定のエラー状態を表すために使用される宣言済み変数です。	`var ErrOutOfTea = fmt.Errorf("no more tea available") var ErrPower = fmt.Errorf("can't boil water")`
	`func makeTea(arg int) error { if arg == 2 { return ErrOutOfTea } else if arg == 4 {`
文脈を追加するために、エラーを上位レベルのエラーでラップできます。これを行う最も簡単な方法は、`fmt.Errorf` の `%w` 述語です。ラップされたエラーは論理的なチェーン（A は B をラップし、B は C をラップするなど）を作成し、`errors.Is` や `errors.As` などの関数で照会できます。	`return fmt.Errorf("making tea: %w", ErrPower) } return nil }`
	`func main() { for _, i := range []int{7, 42} {`
`if` 行でインラインエラーチェックを使用するのが一般的です。	`if r, e := f(i); e != nil { fmt.Println("f failed:", e) } else { fmt.Println("f worked:", r) } }`
	`for i := range 5 { if err := makeTea(i); err != nil {`
`errors.Is` は、特定のエラー（またはそのチェーン内のエラー）が特定のエラー値と一致するかどうかを確認します。これはラップまたはネストされたエラーで特に役立ち、エラーのチェーン内で特定のエラーの種類またはセントリーエラーを識別できます。	`if errors.Is(err, ErrOutOfTea) { fmt.Println("We should buy new tea!") } else if errors.Is(err, ErrPower) { fmt.Println("Now it is dark.") } else { fmt.Printf("unknown error: %s\n", err) } continue }`
	`fmt.Println("Tea is ready!") } }`

$ go run errors.go
f worked: 10
f failed: can't work with 42
Tea is ready!
Tea is ready!
We should buy new tea!
Tea is ready!
Now it is dark.

次の例: カスタムエラー。