errors

Documentation

Overview

Package errors implements functions to manipulate errors.

Example

package main

import (
	"fmt"
	"time"
)

// MyError is an error implementation that includes a time and message.
type MyError struct {
	When time.Time
	What string
}

func main() {
	if err := oops(); err != nil {
		fmt.Println(err)
	}
}

Output:
1989-03-15 22:30:00 +0000 UTC: the file system has gone away

Index

• func New(text string) error

Examples

• Package
• New
• New (Errorf)

Functions

func New

func New(text string) error

New returns an error that formats as the given text.

Example

package main

import (
	"errors"
	"fmt"
)

func main() {
	err := errors.New("emit macho dwarf: elf header corrupted")
	if err != nil {
		fmt.Print(err)
	}
}

Output:
emit macho dwarf: elf header corrupted

Example (Errorf)

The fmt package's Errorf function lets us use the package's formatting features to create descriptive error messages.

package main

import (
	"fmt"
)

func main() {
	const name, id = "bimmler", 17
	err := fmt.Errorf("user %q (id %d) not found", name, id)
	if err != nil {
		fmt.Print(err)
	}
}

Output:
user "bimmler" (id 17) not found