errors

Documentation

Index

• func IsError(actual error, expected error) bool
• func PrintErrorWithStackTrace(err error) string
• func Unwrap(err error) error
• func WithStackTrace(err error) error
• func WithStackTraceAndPrefix(err error, message string, args ...interface{}) error

Functions

func IsError

func IsError(actual error, expected error) bool

Returns true if actual is the same type of error as expected. This method unwraps the given error objects (if they are wrapped in objects with a stacktrace) and then does a simple equality check on them.

func PrintErrorWithStackTrace

func PrintErrorWithStackTrace(err error) string

Convert the given error to a string, including the stack trace if available

func Unwrap

func Unwrap(err error) error

If the given error is a wrapper that contains a stacktrace, unwrap it and return the original, underlying error. In all other cases, return the error unchanged

func WithStackTrace

func WithStackTrace(err error) error

Wrap the given error in an Error type that contains the stack trace. If the given error already has a stack trace, it is used directly. If the given error is nil, return nil.

func WithStackTraceAndPrefix

func WithStackTraceAndPrefix(err error, message string, args ...interface{}) error

Wrap the given error in an Error type that contains the stack trace and has the given message prepended as part of the error message. If the given error already has a stack trace, it is used directly. If the given error is nil, return nil.