version: 1.9.2

package errors

import "errors"

概述

errors 包实现了关于错误处理的函数。

例:

  1. package errors_test
  3. import (
  4.     "fmt"
  5.     "time"
  6. )
  8. // MyError 实现了 error interface，包含一个时间和信息字段。
  9. type MyError struct {
  10.     When time.Time
  11.     What string
  12. }
  14. func (e MyError) Error() string {
  15.     return fmt.Sprintf("%v: %v", e.When, e.What)
  16. }
  18. func oops() error {
  19.     return MyError{
  20.         time.Date(1989, 3, 15, 22, 30, 0, 0, time.UTC),
  21.         "the file system has gone away",
  22.     }
  23. }
  25. func Example() {
  26.     if err := oops(); err != nil {
  27.         fmt.Println(err)
  28.     }
  29.     // Output: 1989-03-15 22:30:00 +0000 UTC: the file system has gone away
  30. }

索引

例子

文件

errors.go

func New 

  1. func New(text string) error

New 方法返回一个以给定文本格式化的 error 对象。

例:

  1. err := errors.New("emit macho dwarf: elf header corrupted")
  2. if err != nil {
  3.     fmt.Print(err)
  4. }
  5. // Output: emit macho dwarf: elf header corrupted

例:

  1. const name, id = "bimmler", 17
  2. err := fmt.Errorf("user %q (id %d) not found", name, id)
  3. if err != nil {
  4.     fmt.Print(err)
  5. }
  6. // Output: user "bimmler" (id 17) not found