Documentation
¶
Index ¶
- Variables
- func As(err error, target interface{}) bool
- func Cause(err error) error
- func Errorf(format string, args ...interface{}) error
- func Is(err, target error) bool
- func IsNotFoundError(err error) bool
- func IsNotImplement(err error) bool
- func IsNotSupportError(err error) bool
- func IsObjectNotFound(err error) bool
- func Join(errs ...error) error
- func New(message string) error
- func NewErr(err error, format string, a ...any) error
- func Unwrap(err error) error
- func WithMessage(err error, message string) error
- func WithMessagef(err error, format string, args ...interface{}) error
- func WithStack(err error) error
- func Wrap(err error, message string) error
- func Wrapf(err error, format string, args ...interface{}) error
- type Frame
- type StackTrace
Constants ¶
This section is empty.
Variables ¶
var ( NotImplement = New("not implement") NotSupport = New("not support") RelativePath = New("using relative path is not allowed") MoveBetweenTwoStorages = New("can't move files between two storages, try to copy") UploadNotSupported = New("upload not supported") MetaNotFound = New("meta not found") StorageNotFound = New("storage not found") StreamIncomplete = New("upload/download stream incomplete, possible network issue") StreamPeekFail = New("StreamPeekFail") UnknownArchiveFormat = New("unknown archive format") WrongArchivePassword = New("wrong archive password") DriverExtractNotSupported = New("driver extraction not supported") )
var ( ObjectNotFound = New("object not found") NotFolder = New("not a folder") NotFile = New("not a file") )
var ( SearchNotAvailable = Errorf("search not available") BuildIndexIsRunning = Errorf("build index is running, please try later") )
var ( EmptyUsername = New("username is empty") EmptyPassword = New("password is empty") WrongPassword = New("password is incorrect") DeleteAdminOrGuest = New("cannot delete admin or guest") )
var (
EmptyToken = New("empty token")
)
var (
PermissionDenied = New("permission denied")
)
Functions ¶
func As ¶ added in v4.3.5
As finds the first error in err's chain that matches target, and if so, sets target to that error value and returns true.
The chain consists of err itself followed by the sequence of errs obtained by repeatedly calling Unwrap.
An error matches target if the error's concrete value is assignable to the value pointed to by target, or if the error has a method As(interface{}) bool such that As(target) returns true. In the latter case, the As method is responsible for setting target.
As will panic if target is not a non-nil pointer to either a type that implements error, or to any interface type. As returns false if err is nil.
func Cause ¶ added in v4.3.5
Cause returns the underlying cause of the error, if possible. An error value has a cause if it implements the following interface:
type causer interface {
Cause() error
}
If the error does not implement Cause, the original error will be returned. If the error is nil, nil will be returned without further investigation.
func Errorf ¶ added in v4.3.5
Errorf formats according to a format specifier and returns the string as a value that satisfies error. Errorf also records the stack trace at the point it was called.
func Is ¶ added in v4.3.5
Is reports whether any error in err's chain matches target.
The chain consists of err itself followed by the sequence of errs obtained by repeatedly calling Unwrap.
An error is considered to match a target if it is equal to that target or if it implements a method Is(error) bool such that Is(target) returns true.
func IsNotFoundError ¶
func IsNotImplement ¶
func IsNotSupportError ¶
func IsObjectNotFound ¶
func Join ¶ added in v4.3.5
Join returns an error that wraps the given errs. Any nil error values are discarded. Join returns nil if every value in errs is nil. The error formats as the concatenation of the strings obtained by calling the Error method of each element of errs, with a newline between each string.
A non-nil error returned by Join implements the Unwrap() []error method.
func New ¶ added in v4.3.5
New returns an error with the supplied message. New also records the stack trace at the point it was called.
func NewErr ¶
NewErr wrap constant error with an extra message use Is(err1, StorageNotFound) to check if err belongs to any internal error
func Unwrap ¶ added in v4.3.5
Unwrap returns the result of calling the Unwrap method on err, if err's type contains an Unwrap method returning error. Otherwise, Unwrap returns nil.
func WithMessage ¶ added in v4.3.5
WithMessage annotates err with a new message. If err is nil, WithMessage returns nil.
func WithMessagef ¶ added in v4.3.5
WithMessagef annotates err with the format specifier. If err is nil, WithMessagef returns nil.
func WithStack ¶ added in v4.3.5
WithStack annotates err with a stack trace at the point WithStack was called. If err is nil, WithStack returns nil.
Types ¶
type Frame ¶ added in v4.3.5
type Frame uintptr
Frame represents a program counter inside a stack frame. For historical reasons if Frame is interpreted as a uintptr its value represents the program counter + 1.
func (Frame) Format ¶ added in v4.3.5
Format formats the frame according to the fmt.Formatter interface.
%s source file %d source line %n function name %v equivalent to %s:%d
Format accepts flags that alter the printing of some verbs, as follows:
%+s function name and path of source file relative to the compile time
GOPATH separated by \n\t (<funcname>\n\t<path>)
%+v equivalent to %+s:%d
func (Frame) MarshalText ¶ added in v4.3.5
MarshalText formats a stacktrace Frame as a text string. The output is the same as that of fmt.Sprintf("%+v", f), but without newlines or tabs.
type StackTrace ¶ added in v4.3.5
type StackTrace []Frame
StackTrace is stack of Frames from innermost (newest) to outermost (oldest).
func (StackTrace) Format ¶ added in v4.3.5
func (st StackTrace) Format(s fmt.State, verb rune)
Format formats the stack of Frames according to the fmt.Formatter interface.
%s lists source files for each Frame in the stack %v lists the source file and line number for each Frame in the stack
Format accepts flags that alter the printing of some verbs, as follows:
%+v Prints filename, function, and line number for each Frame in the stack.
Source Files