go-multierror: github.com/hashicorp/go-multierror Index | Files

package multierror

import "github.com/hashicorp/go-multierror"


Package Files

append.go flatten.go format.go group.go multierror.go prefix.go sort.go

func Flatten Uses

func Flatten(err error) error

Flatten flattens the given error, merging any *Errors together into a single *Error.

func ListFormatFunc Uses

func ListFormatFunc(es []error) string

ListFormatFunc is a basic formatter that outputs the number of errors that occurred along with a bullet point list of the errors.

func Prefix Uses

func Prefix(err error, prefix string) error

Prefix is a helper function that will prefix some text to the given error. If the error is a multierror.Error, then it will be prefixed to each wrapped error.

This is useful to use when appending multiple multierrors together in order to give better scoping.

type Error Uses

type Error struct {
    Errors      []error
    ErrorFormat ErrorFormatFunc

Error is an error type to track multiple errors. This is used to accumulate errors in cases and return them as a single "error".

func Append Uses

func Append(err error, errs ...error) *Error

Append is a helper function that will append more errors onto an Error in order to create a larger multi-error.

If err is not a multierror.Error, then it will be turned into one. If any of the errs are multierr.Error, they will be flattened one level into err. Any nil errors within errs will be ignored. If err is nil, a new *Error will be returned.

func (*Error) Error Uses

func (e *Error) Error() string

func (*Error) ErrorOrNil Uses

func (e *Error) ErrorOrNil() error

ErrorOrNil returns an error interface if this Error represents a list of errors, or returns nil if the list of errors is empty. This function is useful at the end of accumulation to make sure that the value returned represents the existence of errors.

func (*Error) GoString Uses

func (e *Error) GoString() string

func (Error) Len Uses

func (err Error) Len() int

Len implements sort.Interface function for length

func (Error) Less Uses

func (err Error) Less(i, j int) bool

Less implements sort.Interface function for determining order

func (Error) Swap Uses

func (err Error) Swap(i, j int)

Swap implements sort.Interface function for swapping elements

func (*Error) Unwrap Uses

func (e *Error) Unwrap() error

Unwrap returns an error from Error (or nil if there are no errors). This error returned will further support Unwrap to get the next error, etc. The order will match the order of Errors in the multierror.Error at the time of calling.

The resulting error supports errors.As/Is/Unwrap so you can continue to use the stdlib errors package to introspect further.

This will perform a shallow copy of the errors slice. Any errors appended to this error after calling Unwrap will not be available until a new Unwrap is called on the multierror.Error.

func (*Error) WrappedErrors Uses

func (e *Error) WrappedErrors() []error

WrappedErrors returns the list of errors that this Error is wrapping. It is an implementation of the errwrap.Wrapper interface so that multierror.Error can be used with that library.

This method is not safe to be called concurrently and is no different than accessing the Errors field directly. It is implemented only to satisfy the errwrap.Wrapper interface.

type ErrorFormatFunc Uses

type ErrorFormatFunc func([]error) string

ErrorFormatFunc is a function callback that is called by Error to turn the list of errors into a string.

type Group Uses

type Group struct {
    // contains filtered or unexported fields

Group is a collection of goroutines which return errors that need to be coalesced.

func (*Group) Go Uses

func (g *Group) Go(f func() error)

Go calls the given function in a new goroutine.

If the function returns an error it is added to the group multierror which is returned by Wait.

func (*Group) Wait Uses

func (g *Group) Wait() *Error

Wait blocks until all function calls from the Go method have returned, then returns the multierror.

Package multierror imports 5 packages (graph) and is imported by 4602 packages. Updated 2020-06-29. Refresh now. Tools for package owners.