errors

Documentation

Index

• func New(text string) error
• type InvalidUTF8Error
  • func (e *InvalidUTF8Error) Error() string
• type InvalidUnmarshalError
  • func (e *InvalidUnmarshalError) Error() string
• type MarshalerError
  • func ErrMarshaler(typ reflect.Type, err error, msg string) *MarshalerError
  • func (e *MarshalerError) Error() string
  • func (e *MarshalerError) Unwrap() error
• type PathError
  • func ErrEmptyPath() *PathError
  • func ErrInvalidPath(msg string, args ...any) *PathError
  • func (e *PathError) Error() string
• type SyntaxError
  • func ErrExceededMaxDepth(c byte, cursor int64) *SyntaxError
  • func ErrExpected(msg string, cursor int64) *SyntaxError
  • func ErrInvalidBeginningOfValue(c byte, cursor int64) *SyntaxError
  • func ErrInvalidCharacter(c byte, context string, cursor int64) *SyntaxError
  • func ErrNotAtBeginningOfValue(cursor int64) *SyntaxError
  • func ErrSyntax(msg string, offset int64) *SyntaxError
  • func ErrUnexpectedEndOfJSON(msg string, cursor int64) *SyntaxError
  • func (e *SyntaxError) Error() string
• type UnmarshalFieldError
  • func (e *UnmarshalFieldError) Error() string
• type UnmarshalTypeError
  • func (e *UnmarshalTypeError) Error() string
• type UnsupportedTypeError
  • func (e *UnsupportedTypeError) Error() string
• type UnsupportedValueError
  • func (e *UnsupportedValueError) Error() string

Functions

func New

func New(text string) error

New returns an error that formats as the given text. Each call to New returns a distinct error value even if the text is identical.

Types

type InvalidUTF8Error

type InvalidUTF8Error struct {
	S string // the whole string value that caused the error
}

func (*InvalidUTF8Error) Error

func (e *InvalidUTF8Error) Error() string

type InvalidUnmarshalError

type InvalidUnmarshalError struct {
	Type reflect.Type
}

func (*InvalidUnmarshalError) Error

func (e *InvalidUnmarshalError) Error() string

type MarshalerError

type MarshalerError struct {
	Type reflect.Type
	Err  error
	// contains filtered or unexported fields
}

A MarshalerError represents an error from calling a MarshalJSON or MarshalText method.

func ErrMarshaler

func ErrMarshaler(typ reflect.Type, err error, msg string) *MarshalerError

func (*MarshalerError) Error

func (e *MarshalerError) Error() string

func (*MarshalerError) Unwrap

func (e *MarshalerError) Unwrap() error

Unwrap returns the underlying error.

type PathError

type PathError struct {
	// contains filtered or unexported fields
}

func ErrEmptyPath

func ErrEmptyPath() *PathError

func ErrInvalidPath

func ErrInvalidPath(msg string, args ...any) *PathError

func (*PathError) Error

func (e *PathError) Error() string

type SyntaxError

type SyntaxError struct {
	Offset int64 // error occurred after reading Offset bytes
	// contains filtered or unexported fields
}

A SyntaxError is a description of a JSON syntax error.

func ErrExceededMaxDepth

func ErrExceededMaxDepth(c byte, cursor int64) *SyntaxError

func ErrExpected

func ErrExpected(msg string, cursor int64) *SyntaxError

func ErrInvalidBeginningOfValue

func ErrInvalidBeginningOfValue(c byte, cursor int64) *SyntaxError

func ErrInvalidCharacter

func ErrInvalidCharacter(c byte, context string, cursor int64) *SyntaxError

func ErrNotAtBeginningOfValue

func ErrNotAtBeginningOfValue(cursor int64) *SyntaxError

func ErrSyntax

func ErrSyntax(msg string, offset int64) *SyntaxError

func ErrUnexpectedEndOfJSON

func ErrUnexpectedEndOfJSON(msg string, cursor int64) *SyntaxError

func (*SyntaxError) Error

func (e *SyntaxError) Error() string

type UnmarshalFieldError

type UnmarshalFieldError struct {
	Key   string
	Type  reflect.Type
	Field reflect.StructField
}

An UnmarshalFieldError describes a JSON object key that led to an unexported (and therefore unwritable) struct field.

Deprecated: No longer used; kept for compatibility.

func (*UnmarshalFieldError) Error

func (e *UnmarshalFieldError) Error() string

type UnmarshalTypeError

type UnmarshalTypeError struct {
	Value  string       // description of JSON value - "bool", "array", "number -5"
	Type   reflect.Type // type of Go value it could not be assigned to
	Offset int64        // error occurred after reading Offset bytes
	Struct string       // name of the struct type containing the field
	Field  string       // the full path from root node to the field
}

An UnmarshalTypeError describes a JSON value that was not appropriate for a value of a specific Go type.

func (*UnmarshalTypeError) Error

func (e *UnmarshalTypeError) Error() string

type UnsupportedTypeError

type UnsupportedTypeError struct {
	Type reflect.Type
}

An UnsupportedTypeError is returned by Marshal when attempting to encode an unsupported value type.

func (*UnsupportedTypeError) Error

func (e *UnsupportedTypeError) Error() string

type UnsupportedValueError

type UnsupportedValueError struct {
	Value reflect.Value
	Str   string
}

func (*UnsupportedValueError) Error

func (e *UnsupportedValueError) Error() string