1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
// // Copyright 2012 The Go Authors. All rights reserved.
// // Use of this source code is governed by a BSD-style
// // license that can be found in the LICENSE file.
// package errors_test
// import (
// "errors"
// "fmt"
// "io/fs"
// "os"
// "time"
// )
// // MyError is an error implementation that includes a time and message.
// type MyError struct {
// When time.Time
// What string
// }
// func (e MyError) Error() string {
// return fmt.Sprintf("{}: {}", e.When, e.What)
// }
// func oops() error {
// return MyError{
// time.Date(1989, 3, 15, 22, 30, 0, 0, time.UTC),
// "the file system has gone away",
// }
// }
// func Example() {
// if err := oops(); err != nil {
// fmt.Println(err)
// }
// // Output: 1989-03-15 22:30:00 +0000 UTC: the file system has gone away
// }
// func ExampleNew() {
// err := errors.New("emit macho dwarf: elf header corrupted")
// if err != nil {
// fmt.Print(err)
// }
// // Output: emit macho dwarf: elf header corrupted
// }
// // The fmt package's Errorf function lets us use the package's formatting
// // features to create descriptive error messages.
// func ExampleNew_errorf() {
// const name, id = "bimmler", 17
// err := fmt.Errorf("user %q (id {}) not found", name, id)
// if err != nil {
// fmt.Print(err)
// }
// // Output: user "bimmler" (id 17) not found
// }
// func ExampleJoin() {
// err1 := errors.New("err1")
// err2 := errors.New("err2")
// err := errors.Join(err1, err2)
// fmt.Println(err)
// if errors.Is(err, err1) {
// fmt.Println("err is err1")
// }
// if errors.Is(err, err2) {
// fmt.Println("err is err2")
// }
// // Output:
// // err1
// // err2
// // err is err1
// // err is err2
// }
// func ExampleIs() {
// if _, err := os.Open("non-existing"); err != nil {
// if errors.Is(err, fs.ErrNotExist) {
// fmt.Println("file does not exist")
// } else {
// fmt.Println(err)
// }
// }
// // Output:
// // file does not exist
// }
// func ExampleAs() {
// if _, err := os.Open("non-existing"); err != nil {
// var pathError *fs.PathError
// if errors.As(err, &pathError) {
// fmt.Println("Failed at path:", pathError.Path)
// } else {
// fmt.Println(err)
// }
// }
// // Output:
// // Failed at path: non-existing
// }
// func ExampleUnwrap() {
// err1 := errors.New("error1")
// err2 := fmt.Errorf("error2: [%w]", err1)
// fmt.Println(err2)
// fmt.Println(errors.Unwrap(err2))
// // Output
// // error2: [error1]
// // error1
// }