errors

Documentation

Overview

Package errors.

This package can be used as drop-in replacement for https://golang.org/pkg/errors package.

This package provide StackTrace function to get the stack trace, use Wrap to make sure the error have stack trace

Index

• func As(err error, target interface{}) bool
• func Errorf(format string, a ...interface{}) error
• func Format(err error) string
• func Is(err, target error) bool
• func New(text string) error
• func NewWithCause(text string, cause error) error
• func ParentStackTrace(err error) []trace.Location
• func Spawn(f func() error) <-chan error
• func StackTrace(err error) []trace.Location
• func Unwrap(err error) error
• func Wrap(err error) error

Functions

func As

func As(err error, target interface{}) bool

see https://golang.org/pkg/errors/#As

func Errorf

func Errorf(format string, a ...interface{}) error

see https://golang.org/pkg/fmt/#Errorf

func Format

func Format(err error) string

Format representation of the Error, including stack trace.

Use err.Error() if you want to get just the error string

func Is

func Is(err, target error) bool

see https://golang.org/pkg/errors/#Is

func New

func New(text string) error

see https://golang.org/pkg/errors/#New

func NewWithCause

func NewWithCause(text string, cause error) error

like New, but you can specify the cause error

func ParentStackTrace

func ParentStackTrace(err error) []trace.Location

Get stack trace of parent go routine of the error, return nil if none

func Spawn

func Spawn(f func() error) <-chan error

Spawn new go routine

run f, if f panic or returning non-nil error, it will be passed to the error channel

the error passed to the error chanel will return non-nil when passed to ParentStackTrace

func StackTrace

func StackTrace(err error) []trace.Location

Get stack trace of where the error is generated or wrapped, return nil if none

func Unwrap

func Unwrap(err error) error

see https://golang.org/pkg/errors/#Unwrap

func Wrap

func Wrap(err error) error

Wrap the err if the err doens't have stack trace