version: 1.10

package errors

import "errors"

Overview

Package errors implements functions to manipulate errors.

Example:

  1. package errors_test
  3. import (
  4.     "fmt"
  5.     "time"
  6. )
  8. // MyError is an error implementation that includes a time and message.
  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. }

Index

Examples

Package files

errors.go

func New 

  1. func New(text string) error

New returns an error that formats as the given text.

Example:

  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

Example:

  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