Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

errors

package module

Go to main page

Versions in this module

v1

v1.3.0

Dec 22, 2022

Changes in this version

+ const DownstreamDependencyTimedout

+ const Duplicate

+ const Empty

+ const InputBody

+ const Internal

+ const MaximumAttempts

+ const NotFound

+ const SubscriptionExpired

+ const Unauthenticated

+ const Unauthorized

+ const Unavailable

+ const Unknown

+ const Validation

+ var DefaultMarshaller = &MarshalString

+ var ErrNoLocalizer = New("localizer is no set")

+ var ErrNotError = New("not *Error")

+ var ErrUnknownMarshaller = New("marshaller not set")

+ var ErrUnknownType = New("unknown type")

+ var HandlerCaller = Caller(HandlerCallDepth)

+ var RuntimeCaller = Caller(RuntimeCallDepth)

+ func ContainsByErr(err error, target error) bool

+ func ContainsByID(err error, id string) bool

+ func DefaultTranslate(e error) string

+ func Find(err error, fn func(error) bool) error

+ func FindByErr(err error, target error) error

+ func FindByID(err error, id string) error

+ func GRPCStatusCode(err error) (codes.Code, bool)

+ func GRPCStatusCodeMessage(err error) (codes.Code, string, bool)

+ func GetOperation(err error) string

+ func HTTPStatusCode(err error) (int, bool)

+ func HTTPStatusCodeMessage(err error) (int, string, bool)

+ func StatusMessage(err error) (string, bool)

+ func Translate(e error, l Localizer, tctx *TranslateContext) (string, error)

+ type CallDepth int

+ const DefaultCallDepth

+ const HandlerCallDepth

+ const RuntimeCallDepth

+ type CtxKV []struct

type Error

+ func DownstreamDependencyTimedoutErr(s string) *Error

+ func DownstreamDependencyTimedoutErrWith(ops ...Options) *Error

+ func DuplicateErr(s string) *Error

+ func DuplicateErrWith(ops ...Options) *Error

+ func EmptyErr(s string) *Error

+ func EmptyErrWith(ops ...Options) *Error

+ func InputBodyErr(s string) *Error

+ func InputBodyErrWith(ops ...Options) *Error

+ func IternalErr(s string) *Error

+ func IternalErrWith(ops ...Options) *Error

+ func MaximumAttemptsErr(s string) *Error

+ func MaximumAttemptsErrWith(ops ...Options) *Error

+ func NewLog(i interface{}) *Error

+ func NewWith(ops ...Options) *Error

+ func NotFoundErr(s string) *Error

+ func NotFoundErrWith(ops ...Options) *Error

+ func SubscriptionExpiredErr(s string) *Error

+ func SubscriptionExpiredErrWith(ops ...Options) *Error

+ func UnauthenticatedErr(s string) *Error

+ func UnauthenticatedErrWith(ops ...Options) *Error

+ func UnauthorizedErr(s string) *Error

+ func UnauthorizedErrWith(ops ...Options) *Error

+ func UnavailableErr(s string) *Error

+ func UnavailableErrWith(ops ...Options) *Error

+ func ValidationErr(s string) *Error

+ func ValidationErrWith(ops ...Options) *Error

+ func (e *Error) Marshal(fn ...Marshaller) ([]byte, error)

+ func (e *Error) Operation() string

+ type IErrType interface

+ GRPCStatusCode func() codes.Code

+ HTTPStatusCode func() int

+ Number func() int

+ String func() string

+ func GetErrType(err error) (IErrType, bool)

+ func ParseErrType(s string) IErrType

+ type Localizer interface

+ Localize func(*i18n.LocalizeConfig) (string, error)

+ type Logger interface

+ Errorf func(format string, args ...interface{})

+ var DefaultLogger Logger = multilog.DefaultLogger

+ type MarshalJSON struct

+ func (MarshalJSON) MarshalTo(i interface{}, dst io.Writer) error

+ func (m *MarshalJSON) Marshal(i interface{}) ([]byte, error)

+ type MarshalString struct

+ func (m *MarshalString) Marshal(i interface{}) ([]byte, error)

+ func (m *MarshalString) MarshalTo(i interface{}, dst io.Writer) error

+ type Marshaller interface

+ Marshal func(interface{}) ([]byte, error)

+ MarshalTo func(interface{}, io.Writer) error

type Multierror

+ func CastMultierr(err error) (Multierror, bool)

+ Last func() error

+ Len func() int

+ Log func(l ...Logger)

+ Marshal func(fn ...Marshaller) ([]byte, error)

+ Unwrap func() error

type Options

+ func SetOperation(o string) Options

v1.2.3

May 31, 2021

Changes in this version

+ var DefaultCaller = Caller(3)

+ var DefaultFormatFn FormatFn

+ var DefaultLocalizer *i18n.Localizer

+ var DefaultMultierrFormatFunc MultierrFormatFn

+ var ErrNotValidSeverity = origerrors.New("not a valid severity")

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

+ func Caller(depth int) func() string

+ func Combine(errors ...error) error

+ func CombineWithLog(errs ...error) error

+ func Contains(err error, id string) bool

+ func ErrorOrNil(err error) error

+ func Errors(err error) []error

+ func GetErrorType(err error) string

+ func GetID(err error) (id string)

+ func Is(err, target error) bool

+ func JSONFormat(buf io.Writer, e *Error)

+ func JSONMultierrFuncFormat(w io.Writer, es []error)

+ func Log(err error, l ...multilog.Logger)

+ func StringFormat(buf io.Writer, e *Error)

+ func StringMultierrFormatFunc(w io.Writer, es []error)

+ func Unwrap(err error) error

+ func Wrap(left error, right error) error

+ func WrapWithLog(olderr error, err error) error

+ type CtxMap map[string]interface

+ type Error struct

+ func Cast(err error) *Error

+ func New(msg string, ops ...Options) *Error

+ func NewWithLog(msg string, ops ...Options) *Error

+ func UnwrapByID(err error, id string) *Error

+ func (e *Error) As(target interface{}) bool

+ func (e *Error) ContextInfo() CtxMap

+ func (e *Error) Error() string

+ func (e *Error) ErrorOrNil() error

+ func (e *Error) ErrorType() Objecter

+ func (e *Error) Format(s fmt.State, verb rune)

+ func (e *Error) ID() Objecter

+ func (e *Error) Is(target error) bool

+ func (e *Error) Localizer() *i18n.Localizer

+ func (e *Error) Log(l ...multilog.Logger)

+ func (e *Error) Msg() Objecter

+ func (e *Error) Operations() Objects

+ func (e *Error) Sdump() string

+ func (e *Error) Severity() Severity

+ func (e *Error) TranslateContext() *TranslateContext

+ func (e *Error) TranslateMsg() string

+ func (e *Error) Unwrap() error

+ func (e *Error) WithOptions(ops ...Options) *Error

+ func (e *Error) WriteTranslateMsg(w io.Writer) (int, error)

+ type FormatFn func(w io.Writer, e *Error)

+ type MultierrFormatFn func(w io.Writer, es []error)

+ type Multierror interface

+ Error func() string

+ Errors func() []error

+ Format func(f fmt.State, c rune)

+ type Objecter interface

+ Buffer func() *bytes.Buffer

+ Bytes func() []byte

+ String func() string

+ func NewObjectEmpty() Objecter

+ func NewObjectFromBytes(v []byte) Objecter

+ func NewObjectFromString(s string) Objecter

+ type Objects []Objecter

+ func NewObjects(oo ...Objecter) Objects

+ func NewObjectsFromBytes(vv ...[]byte) Objects

+ func NewObjectsFromString(ss ...string) Objects

+ func (os Objects) Append(oo ...Objecter) Objects

+ func (os Objects) AppendBytes(vv ...[]byte) Objects

+ func (os Objects) AppendString(ss ...string) Objects

+ type Options func(e *Error)

+ func AppendContextInfo(key string, value interface{}) Options

+ func AppendOperations(o ...string) Options

+ func AppendOperationsBytes(o ...[]byte) Options

+ func SetContextInfo(ctxinf CtxMap) Options

+ func SetErrorType(etype string) Options

+ func SetErrorTypeBytes(etype []byte) Options

+ func SetFormatFn(fn FormatFn) Options

+ func SetID(id string) Options

+ func SetIDBytes(id []byte) Options

+ func SetLocalizer(localizer *i18n.Localizer) Options

+ func SetMsg(msg string) Options

+ func SetMsgBytes(msg []byte) Options

+ func SetOperations(o ...string) Options

+ func SetOperationsBytes(o ...[]byte) Options

+ func SetSeverity(severity Severity) Options

+ func SetSeverityErr() Options

+ func SetSeverityWarn() Options

+ func SetTranslateContext(tctx *TranslateContext) Options

+ type Severity uint32

+ const SeverityEnds

+ const SeverityError

+ const SeverityUnknown

+ const SeverityWarn

+ func ParseSeverityString(v string) (s Severity, err error)

+ func ParseSeverityUint(v uint32) (s Severity, err error)

+ func (s Severity) Bytes() (buf []byte)

+ func (s Severity) String() (str string)

+ func (s Severity) Uint32() uint32

+ func (s Severity) Valid() bool

+ type TranslateContext struct

+ DefaultMessage *i18n.Message

+ PluralCount interface{}

+ TemplateData map[string]interface{}