optional

type Optional ¶

type Optional[T any] struct {
	Value   T
	Null    bool
	Present bool
}

Optional is an optional value. When unmarshaling a struct, if the value is not present, o.Present and o.Null are false, and o.Value is the zero value for T.

Note that Go doesn't let us control marshaling as much as unmarshaling, so the reverse is not possible. Optional is marshaled as null if o.Null is true or o.Present is false.

func NewWithValue[T any](v T) Optional[T]

func Null[T any]() Optional[T]

func (o Optional[T]) MarshalJSON() ([]byte, error)

func (o *Optional[T]) UnmarshalJSON(src []byte) error