result

Documentation

Overview

Package result provides a Result type that can contain a value or an error.

Index

• func Go[T any](f func() (T, error)) chan Result[T]
• type Result
  • func Err[T any](err error) Result[T]
  • func Errf[T any](format string, args ...interface{}) Result[T]
  • func Errorf[T any](format string, args ...interface{}) Result[T]
  • func From[T any](value T, err error) Result[T]
  • func Ok[T any](value T) Result[T]
  • func Outcome[T any](value T, err error) Result[T]
  • func (r Result[T]) Default(value T) T
  • func (r Result[T]) Err() error
  • func (r Result[T]) Get() (T, bool)
  • func (r Result[T]) GoString() string
  • func (r Result[T]) MarshalJSON() ([]byte, error)
  • func (r Result[T]) Result() (T, error)
  • func (r Result[T]) String() string
  • func (r *Result[T]) UnmarshalJSON(data []byte) error

Functions

func Go

func Go[T any](f func() (T, error)) chan Result[T]

Go runs a function in a goroutine and returns a channel that will receive the Result.

Types

type Result

type Result[T any] struct {
	// contains filtered or unexported fields
}

A Result type is a type that can contain an error or a value.

func Err

func Err[T any](err error) Result[T]

Err returns a Result that contains an error.

func Errf

func Errf[T any](format string, args ...interface{}) Result[T]

Errf returns a Result that contains a formatted error.

func Errorf

func Errorf[T any](format string, args ...interface{}) Result[T]

Errorf returns a Result that contains a formatted error.

Deprecated: Use Errf instead.

func From

func From[T any](value T, err error) Result[T]

From returns a Result that contains a value or an error.

It can be used to convert a function that returns a value and an error into a Result.

func Ok

func Ok[T any](value T) Result[T]

Ok returns a Result that contains a value.

func Outcome

func Outcome[T any](value T, err error) Result[T]

Outcome returns a Result that contains a value or an error.

It can be used to convert a function that returns a value and an error into a Result.

Deprecated: Use From instead.

func (Result[T]) Default

func (r Result[T]) Default(value T) T

Default returns the Result value if it is present, otherwise it returns the value passed.

func (Result[T]) Err

func (r Result[T]) Err() error

Err returns the error, if any.

func (Result[T]) Get

func (r Result[T]) Get() (T, bool)

Get returns the value and a boolean indicating whether the value is present.

func (Result[T]) GoString

func (r Result[T]) GoString() string

func (Result[T]) MarshalJSON

func (r Result[T]) MarshalJSON() ([]byte, error)

func (Result[T]) Result

func (r Result[T]) Result() (T, error)

Result returns the underlying value and error.

func (Result[T]) String

func (r Result[T]) String() string

func (*Result[T]) UnmarshalJSON

func (r *Result[T]) UnmarshalJSON(data []byte) error