README
¶
Errors
Improved error handling compatible with standard library
package main
import (
"fmt"
goerr "errors"
"github.com/difof/goul/errors"
)
func someerrfunc() error {
return goerr.New("some error")
}
func DoSomething() error {
return errors.Newi(someerrfunc(), "something went wrong")
}
func DoSomethingTwoReturns() error {
return errors.CheckAny(TwoReturns())(
// This callback is called if TwoReturns() returns result, nil
func(result int) error {
// do something with result
return nil
})
}
func TwoReturns() (int, error) {
result := 223
return result, errors.Newm("something went wrong")
}
func main() {
// Simple use which prints stack trace
if err := DoSomething(); err != nil {
fmt.Println(err)
}
// Dual return values
if err := DoSomethingTwoReturns(); err != nil {
fmt.Println(err)
}
}
Documentation
¶
Index ¶
- func As(err error, target interface{}) bool
- func Check(err error) error
- func CheckAny[R any](result R, err error) func(func(R) error) error
- func CheckAnyf[R any](result R, err error) func(func(R) error, string, ...any) error
- func Checkf(err error, msg string, params ...interface{}) error
- func Ignore[T any](r T, _ error) T
- func IgnoreCheckAny[R any]() func(R) error
- func Is(err, target error) bool
- func Must[T any](r T, err error) T
- func New(err error) error
- func Newf(format string, params ...interface{}) error
- func Newi(inner error, msg string) error
- func Newif(inner error, format string, params ...interface{}) error
- func Newm(msg string) error
- func News(skip int, err error) error
- func Newsf(skip int, format string, params ...interface{}) error
- func Newsi(skip int, inner error, msg string) error
- func Newsif(skip int, inner error, format string, params ...interface{}) error
- func Unwrap(err error) error
- type Error
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func CheckAny ¶ added in v0.2.1
CheckAny is used for two return values function which also returns an error.
It calls the given function if the error is nil, otherwise it returns the error. Also returns the error returned by the given function.
This function is a shortcut for when you either return an error or handle a result as last statement in a function.
func CheckAnyf ¶ added in v0.2.3
CheckAnyf is used for two return values function which also returns an error.
It calls the given function if the error is nil, otherwise it returns the error. Also returns the error returned by the given function.
This function is a shortcut for when you either return an error or handle a result as last statement in a function.
func Checkf ¶ added in v0.2.3
Checkf returns error or nil. If error is not nil, it will be wrapped with the given message
func IgnoreCheckAny ¶ added in v0.2.1
Types ¶
type Error ¶
Error is a lightweight error struct with stack trace. Compatible with standard errors package.
Use NewXY functions to construct new errors.
func (*Error) StackTrace ¶
StackTrace builds the stack trace of all inner errors of Error
Source Files