错误堆栈

示例：

可以看到，调用端可以通过Wrap方法将底层的错误信息进行层级叠加，并且包含完整的错误堆栈信息。

HasStack 判断是否实现堆栈

  • 说明：通过HasStack方法我们可以判断给定的error接口对象是否实现（包含）了堆栈信息。

  • 格式：

    1. HasStack(err error) bool
    1. func ExampleHasStack() {
    2.     err1 := errors.New("sql error")
    3.     err2 := gerror.New("write error")
    4.     fmt.Println(gerror.HasStack(err1))
    5.     fmt.Println(gerror.HasStack(err2))
    7.     // Output:
    8.     // false
    9.     // true
    10. }

Stack 获取堆栈信息

  • 说明：通过Stack方法我们可以获得error对象的完整堆栈信息，返回堆栈列表字符串。 注意参数为标准库error类型，当该参数为gerror模块生成的error时， 或者开发者自定义的error对象实现了该接口时支持打印，否则，返回空字符串。

  • 格式：

  • 示例：

    1. func ExampleStack() {
    2.      var err error
    3.     err = errors.New("sql error")
    4.     err = gerror.Wrap(err, "adding failed")
    6.     fmt.Println(gerror.Stack(err))
    8.     // Output:
    9.     //     1).  main.main
    10.     //         /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/other/test.go:14
    11.     // 2. adding failed
    12.     //     1).  main.main
    13.     //         /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/other/test.go:13
    14.     // 3. sql error
    15. }

Current 获取当前error

  • 说明：Current方法用于获取当前层级的错误信息，通过error接口对象返回。

  • 格式：

    1. Current(err error) error

Next 获取下一层error

  • 说明：Next方法用于获取层级错误的下一级错误error接口对象。当下一层级不存在时，返回nil。

  • 格式：

    1. Next(err error) error

  • 示例：

    1. func ExampleNext() {
    2.     var err error
    3.     err = errors.New("sql error")
    4.     err = gerror.Wrap(err, "adding failed")
    5.     err = gerror.Wrap(err, "api calling failed")
    7.     fmt.Println(err)
    9.     err = gerror.Next(err)
    10.     fmt.Println(err)
    12.     err = gerror.Next(err)
    13.     fmt.Println(err)
    16.     // adding failed: sql error
    17.     // sql error
    18. }

Cause 获取根error

  • 说明：通过Cause方法我们可以获得error对象的根错误信息（原始错误）。 注意参数为标准库error类型，当该参数为gerror模块生成的error时， 或者开发者自定义的error对象实现了该接口方法时支持打印，否则，返回输出的error对象。

  • 格式：

    1. package main
    3. import (
    4.     "fmt"
    5.     "github.com/gogf/gf/v2/errors/gerror"
    6. )
    8. func OpenFile() error {
    9.     return gerror.New("permission denied")
    10. }
    12. func OpenConfig() error {
    13.     return gerror.Wrap(OpenFile(), "configuration file opening failed")
    14. }
    16. func ReadConfig() error {
    17.     return gerror.Wrap(OpenConfig(), "reading configuration failed")
    18. }
    20. func main() {
    21.     fmt.Println(gerror.Cause(ReadConfig()))
    22. }