一文详解Golang中的errors包

 更新时间:2023年07月11日 10:51:48   作者:路多辛  
在 Golang 中,errors 包是用于处理错误的标准库, errors 包提供的功能比较简单,使用起来非常方便,接下来就具体讲解一下 errors 包提供的几个函数,感兴趣的小伙伴跟着小编一起来看看吧

errors.New

func New(text string) error

错误处理是开发过程中必不可少的,使用 errors.New 函数可以创建一个表示特定错误的对象。接受一个字符串类型的参数(用于描述错误信息),返回一个 error 类型的值。例如:

package main
import "errors"
func main() {
	err := errors.New("invalid input")
}

error 类型是 builtin 包中定义的一个接口,定义如下:

type error interface {
	Error() string
}

可以看出此接口定义了一个基本的 Error 方法,用于返回错误的描述信息。

package main
import (
	"errors"
	"fmt"
)
func main() {
	err := errors.New("invalid input")
	errDesc := err.Error()
	fmt.Println(errDesc) // 输出 invalid input
}

errors.Is

func Is(err, target error) bool

用于判断给定的错误是否是目标错误类型或者基于目标错误类型包装过的错误,会递归检查错误链,直到找到目标错误类型或者到达错误链的末尾。如果找到目标错误类型,则返回true,否则返回false。看个例子:

package main
import (
	"errors"
	"fmt"
)
func main() {
	err := errors.New("invalid input")
	err1 := errors.New("invalid input")
	err2 := fmt.Errorf("err2: [%w]", err)
	fmt.Println(errors.Is(err1, err)) // false
	fmt.Println(errors.Is(err2, err)) // true
}

因为 err 和 err1 都是使用 errors.New 函数创建的,所以使用 Is 判断会返回 false。err2 是基于 err 包装出来的,所以使用 Is 判断会返回 true。

errors.AS

func As(err error, target any) bool

用于将错误转换为特定类型的错误,As 函数会检查 err 是否是 target 指向的类型的实例,如果是,将该实例赋值给 target 并返回 true。否则返回 false。看个例子:

package main
import (
	"errors"
	"fmt"
)
type MyError struct {
	Message string
}
func (e *MyError) Error() string {
	return e.Message
}
func main() {
	err := &MyError{
		Message: "This is a custom error",
	}
	var target *MyError
	if errors.As(err, &target) {
		fmt.Println("Custom error found:", target.Message)
	} else {
		fmt.Println("Custom error not found")
	}
}

使用 errors.As 来检查 err 是否是 MyError 类型的实例,并将实例赋值给 target。运行一下示例看下效果

$ go run main.go
Custom error found: This is a custom error

这个功能通常用于处理不同类型的错误,根据错误的类型采取对应的处理方式。

errors.Unwrap

func Unwrap(err error) error

用于将一个错误对象展开,得到下一层错误对象,如果错误对象没有下一层错误对象,则返回 nil。看个例子:

package main
import (
	"errors"
	"fmt"
)
func main() {
  originalErr := errors.New("original error")
	err := fmt.Errorf("error: %w", originalErr)
	unwrappedErr := errors.Unwrap(err)
	fmt.Println(unwrappedErr) // 输出: original error
}

使用 fmt.Errorf 函数将 originalErr 做了一层包装后得到 err,然后通过使用 Unwrap 将 err 解包并得包装前的错误对象 originalErr。需要注意的是 Unwrap 只能展开被 fmt.Errorf 包装的错误对象。如果想要展开其他类型的错误对象,可以使用类型断言操作符 `.` 进行类型断言。

小结

errors 包提供了一些简单易用的函数来处理和获取错误信息,借助 errors 包可以实现非常强大的错误处理功能。

到此这篇关于一文详解Golang中的errors包的文章就介绍到这了,更多相关Golang errors包内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • golang日志包logger的用法详解

    golang日志包logger的用法详解

    这篇文章主要介绍了golang日志包logger的用法详解,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-05-05
  • VSCode必装Go语言以下插件的思路详解

    VSCode必装Go语言以下插件的思路详解

    这篇文章主要介绍了VSCode必装Go语言以下插件的思路详解,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-04-04
  • go语言搬砖之go jmespath实现查询json数据

    go语言搬砖之go jmespath实现查询json数据

    这篇文章主要为大家介绍了go语言搬砖之go jmespath实现查询json数据,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-06-06
  • Go读取配置文件的方法总结

    Go读取配置文件的方法总结

    我们常见的配置文件的格式一般有:XML、JSON、INI、YAML、env和.properties,本文小编为大家整理了Go语言读取这些格式的配置文件的方法,希望对大家有所帮助
    2023-10-10
  • Go语言使用Gin处理路由参数和查询参数

    Go语言使用Gin处理路由参数和查询参数

    在 Web API 开发中,处理 路由参数(Path Parameter)  和 查询参数(Query Parameter)  是非常常见的需求,下面我们就来看看Go语言如何使用Gin 框架处理路由参数和查询参数吧
    2025-08-08
  • Go中的动态速率限制有效控制流量

    Go中的动态速率限制有效控制流量

    这篇文章主要为大家介绍了Go中的动态速率限制有效控制流量,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-10-10
  • 使用gin框架搭建简易服务的实现方法

    使用gin框架搭建简易服务的实现方法

    go语言web框架挺多的,本文就介绍了一下如何使用gin框架搭建简易服务的实现方法,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-12-12
  • Go实现并发的示例代码

    Go实现并发的示例代码

    Go语言的并发机制是其强大和流行的一个关键特性之一,本文主要介绍了Go实现并发的示例代码,具有一定的参考价值,感兴趣的可以了解一下
    2023-11-11
  • Go中groutine通信与context控制实例详解

    Go中groutine通信与context控制实例详解

    随着context包的引入,标准库中很多接口因此加上了context参数,下面这篇文章主要给大家介绍了关于Go中groutine通信与context控制的相关资料,需要的朋友可以参考下
    2022-02-02
  • golang 对象深拷贝的常见方式及性能

    golang 对象深拷贝的常见方式及性能

    这篇文章主要介绍了golang 对象深拷贝的常见方式及性能,Go语言中所有赋值操作都是值传递,如果结构中不含指针,则直接赋值就是深度拷贝,文章围绕主题展开更多相关资料,需要的小伙伴可以参考一下
    2022-06-06

最新评论