Skip to main content
Version: 2.7.x(Latest)

本章节仅介绍一些常用方法,完整的错误方法请参考接口文档: https://pkg.go.dev/github.com/gogf/gf/v2/errors/gerror

New/Newf

  • 说明:用于创建一个自定义错误信息的 error 对象,并包含堆栈信息。

  • 格式:

    // New creates and returns an error which is formatted from given text.
    New(text string) error

    // Newf returns an error that formats as the given format and args.
    Newf(format string, args ...interface{}) error

Wrap/Wrapf

  • 说明:用于包裹其他错误 error 对象,构造成多级的错误信息,包含堆栈信息。

  • 格式:

    // Wrap wraps error with text. It returns nil if given err is nil.
    // Note that it does not lose the error code of wrapped error, as it inherits the error code from it.
    func Wrap(err error, text string) error

    // Wrapf returns an error annotating err with a stack trace at the point Wrapf is called, and the format specifier.
    // It returns nil if given `err` is nil.
    // Note that it does not lose the error code of wrapped error, as it inherits the error code from it.
    func Wrapf(err error, format string, args ...interface{}) error

NewSkip/NewSkipf

  • 说明:用于创建一个自定义错误信息的 error 对象,并且忽略部分堆栈信息(按照当前调用方法位置往上忽略)。高级功能,一般开发者很少用得到。

  • 格式:

    // NewSkip creates and returns an error which is formatted from given text.
    // The parameter `skip` specifies the stack callers skipped amount.
    func NewSkip(skip int, text string) error

    // NewSkipf returns an error that formats as the given format and args.
    // The parameter `skip` specifies the stack callers skipped amount.
    func NewSkipf(skip int, format string, args ...interface{}) error

WrapSkip/WrapSkipf

  • 说明:类似于Warp/Wrapf方法,但会忽略部分堆栈信息。

  • 格式:

    // WrapSkip wraps error with text. It returns nil if given err is nil.
    // The parameter `skip` specifies the stack callers skipped amount.
    // Note that it does not lose the error code of wrapped error, as it inherits the error code from it.
    func WrapSkip(skip int, err error, text string) error

    // WrapSkipf wraps error with text that is formatted with given format and args. It returns nil if given err is nil.
    // The parameter `skip` specifies the stack callers skipped amount.
    // Note that it does not lose the error code of wrapped error, as it inherits the error code from it.
    func WrapSkipf(skip int, err error, format string, args ...interface{}) error