Skip to main content
Version: 2.1.x

NewOption 自定义配置的错误对象创建​

  • 说明：用于自定义配置的错误对象创建。
  • 格式：
NewOption(option Option) error
  • 示例：
func ExampleNewOption() {
       err := gerror.NewOption(gerror.Option{
          Text: "this feature is disabled in this storage",
          Code: gcode.CodeNotSupported,
      })
}

fmt 格式化​

通过以上示例我们可以看到，通过 %+v 的打印格式可以打印出完整的堆栈信息，当然 gerror.Error 对象支持多种fmt格式：

格式符输出内容
%v, %s打印所有的层级错误信息，构成完成的字符串返回，多个层级使用 : 拼接。
%-v, %-s打印当前层级的错误信息，返回字符串。
%+s打印完整的堆栈信息列表。
%+v打印所有的层级错误信息字符串，以及完整的堆栈信息，等同于 %s\n%+s。

使用示例：

package main

import (
    "errors"
    "fmt"
    "github.com/gogf/gf/v2/errors/gerror"
)

func main() {
    var err error
    err = errors.New("sql error")
    err = gerror.Wrap(err, "adding failed")
    err = gerror.Wrap(err, "api calling failed")
    fmt.Printf(" %%s: %s\n", err)
    fmt.Printf("%%-s: %-s\n", err)
    fmt.Println("%+s: ")
    fmt.Printf("%+s\n", err)
}

// Output:
//  %s: api calling failed: adding failed: sql error
// %-s: api calling failed
// %+s:
// 1. api calling failed
//     1).  main.main
//         /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/other/test.go:14
// 2. adding failed
//     1).  main.main
//         /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/other/test.go:13
// 3. sql error

日志输出支持​

glog 日志管理模块天然支持对 gerror 错误堆栈打印支持，这种支持不是强耦合性的，而是通过 fmt 格式化打印接口支持的。

使用示例：

package main

import (
    "errors"
    "github.com/gogf/gf/v2/frame/g"
    "github.com/gogf/gf/v2/errors/gerror"
)

func main() {
    var err error
    err = errors.New("sql error")
    err = gerror.Wrap(err, "adding failed")
    err = gerror.Wrap(err, "api calling failed")
    g.Log().Printf("%+v", err)
}

// Output:
// 2020-10-17 15:22:26.793 api calling failed: adding failed: sql error
// 1. api calling failed
//     1).  main.main
//         /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/other/test.go:14
// 2. adding failed
//     1).  main.main
//         /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/.example/other/test.go:13
// 3. sql error