errors

Documentation

Overview

Package errors implements functions to manipulate errors.

Index

• func New(text string) error

Examples

• 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