完善 errno 函数注释

Author: thinkeridea

errno/error.go

@@ -12,6 +12,10 @@ type wrapError struct {
 	msg string
 }
 
+// Wrap 包装一个错误，这个辅助 wrap 实现错误包装使用的
+// 当被包装的 err 为 nil 时会返回自身
+// 当首次被包装且 err 为 Errno 实现，这不设置错误消息
+// 使用 `old err, new err` 格式存储错误信息
 func (w *wrapError) Wrap(err error) *wrapError {
 	if err == nil {
 		return w
@@ -34,13 +38,16 @@ func (w *wrapError) Wrap(err error) *wrapError {
 	return &wrapError{old: w, new: err, msg: msg}
 }
 
+// Error 响应一个被格式化的错误文本，这是 error 接口的实现
 func (w *wrapError) Error() string {
 	if w == nil {
 		return ""
 	}
 	return w.msg
 }
 
+// Is 这是 errors.Is 接口实现，可以通过 errors.Is 函数判断是否包含某个具体的错误
+// 更详细的细节请浏览 errors.Is 文档
 func (w *wrapError) Is(target error) bool {
 	if w == target {
 		return true
@@ -56,6 +63,8 @@ func (w *wrapError) Is(target error) bool {
 	return false
 }
 
+// As 这是 errors.As 接口实现，可以通过 errors.As 函数判断是否包含某个类型的错误，并把发现的第一个错误赋值给 target
+// 更详细的细节请浏览 errors.As 文档
 func (w *wrapError) As(target interface{}) bool {
 	for w != nil {
 		if errors.As(w.new, target) {
@@ -68,6 +77,10 @@ func (w *wrapError) As(target interface{}) bool {
 	return false
 }
 
+// Unwrap 返回最后被包装的错误
+// 这并不是 errors 中的 Unwrap 接口实现，而且用来获取最后绑定的错误
+// 如果需要判断是否包含某个错误请使用 errors.Is
+// 如果判断是否包含的某种类型的错误，请使用 errors.As
 func (w *wrapError) Unwrap() error {
 	if w == nil {
 		return nil

errno/wrap.go

@@ -166,13 +166,17 @@ func (w *wrap) Unwrap() error {
 	return w.err
 }
 
+// Is 这是 errors.Is 接口实现，可以通过 errors.Is 函数判断 WrapErrno 是否包含某个具体的错误
+// 更详细的细节请浏览 errors.Is 文档
 func (w *wrap) Is(target error) bool {
 	if w == nil {
 		return false
 	}
 	return w.err.Is(target)
 }
 
+// As 这是 errors.As 接口实现，可以通过 errors.As 函数判断 WrapErrno 是否包含某个类型的错误，并把发现的第一个错误赋值给 target
+// 更详细的细节请浏览 errors.As 文档
 func (w *wrap) As(target interface{}) bool {
 	if w == nil {
 		return false