26 lines
1.0 KiB
Go
26 lines
1.0 KiB
Go
|
// Copyright 2019 The Go Authors. All rights reserved.
|
||
|
|
// Use of this source code is governed by a BSD-style
|
||
|
|
// license that can be found in the LICENSE file.
|
||
|
|
|
||
|
|
// Package xerrors implements functions to manipulate errors.
|
||
|
|
//
|
||
|
|
// This package supports transitioning to the Go 2 proposal for error values:
|
||
|
|
// https://golang.org/design/29934-error-values
|
||
|
|
//
|
||
|
|
// Most of the functions and types in this package will be incorporated into the
|
||
|
|
// standard library's errors package in Go 1.13; the behavior of this package's
|
||
|
|
// Errorf function will be incorporated into the standard library's fmt.Errorf.
|
||
|
|
// Use this package to get equivalent behavior in all supported Go versions. For
|
||
|
|
// example, create errors using
|
||
|
|
//
|
||
|
|
// xerrors.New("write failed")
|
||
|
|
//
|
||
|
|
// or
|
||
|
|
//
|
||
|
|
// xerrors.Errorf("while reading: %v", err)
|
||
|
|
//
|
||
|
|
// If you want your error type to participate in the new formatting
|
||
|
|
// implementation for %v and %+v, provide it with a Format method that calls
|
||
|
|
// xerrors.FormatError, as shown in the example for FormatError.
|
||
|
|
package xerrors // import "golang.org/x/xerrors"
|