errors

Documentation

Index

• Variables
• func Catch(e error, action Action) bool
• func ErrorFormat(e error, format ...ErrFormat) (s string)
• func Join(e ...error) error
• func Unwrap(e error) []error
• type Action
  • func (t Action) Append(child string) Action
  • func (t Action) Catch(e error) bool
  • func (t Action) Error() string
  • func (t Action) New(reason ...string) (e Error)
  • func (t Action) NewErr(err ...error) (e error)
  • func (t Action) Unwrap() []error
• type ErrFormat
• type Error
  • func New(reason string, action ...Action) (e Error)
  • func (t Error) Error() string
  • func (t Error) Is(e error) bool
  • func (t Error) Unwrap() error
  • func (t Error) WithReason(reason string) Error

Variables

var Is = errors.Is

Functions

func Catch

func Catch(e error, action Action) bool

func ErrorFormat

func ErrorFormat(e error, format ...ErrFormat) (s string)

按格式显示err

默认使用ErrSimplifyFunc 即 e.Error() + "\n"

func Join

func Join(e ...error) error

func Unwrap

func Unwrap(e error) []error

Types

type Action

type Action string

func (Action) Append

func (t Action) Append(child string) Action

func (Action) Catch

func (t Action) Catch(e error) bool

func (Action) Error

func (t Action) Error() string

func (Action) New

func (t Action) New(reason ...string) (e Error)

func (Action) NewErr

func (t Action) NewErr(err ...error) (e error)

func (Action) Unwrap

func (t Action) Unwrap() []error

type ErrFormat

type ErrFormat func(e error) string

var (
	// e.Error() + "\n"
	ErrSimplifyFunc ErrFormat = func(e error) string {
		return e.Error() + "\n"
	}
	// 如是action，则 string(err.action) + ":" + e.Error() + "\n"
	//
	// 否则e.Error() + "\n"
	ErrActionSimplifyFunc ErrFormat = func(e error) string {
		if err, ok := e.(Error); ok && string(err.action) != err.Reason {
			return string(err.action) + ":" + e.Error() + "\n"
		} else {
			return e.Error() + "\n"
		}
	}
	// "> " + e.Error() + " "
	ErrInLineFunc ErrFormat = func(e error) string {
		return "> " + e.Error() + " "
	}
	// 如是action，则 "> " + string(err.action) + ":" + e.Error() + " "
	//
	// 否则"> " + e.Error() + " "
	ErrActionInLineFunc ErrFormat = func(e error) string {
		if err, ok := e.(Error); ok && string(err.action) != err.Reason {
			return fmt.Sprintf("> %v:%v ", err.action, strings.TrimSpace(e.Error()))
		} else {
			return fmt.Sprintf("> %v ", strings.TrimSpace(e.Error()))
		}
	}
)

type Error

type Error struct {
	Reason string
	// contains filtered or unexported fields
}

func New

func New(reason string, action ...Action) (e Error)

func (Error) Error

func (t Error) Error() string

func (Error) Is

func (t Error) Is(e error) bool

func (Error) Unwrap

func (t Error) Unwrap() error

func (Error) WithReason

func (t Error) WithReason(reason string) Error