kern/v4/lev1/option/option.go

package option

import (
	"reflect"

	. "gitp78su.ipnodns.ru/svi/kern/v4/lev0/helpers"
	. "gitp78su.ipnodns.ru/svi/kern/v4/lev0/ktypes"
)

// Option -- результат возможно содержащий nil.
type Option[T any] struct {
	val *T
}

// NewOpt - полезный результат.
func NewOpt[T any](value T) *Option[T] {
	// Для некоторых типов нужна дополнительная проверка через reflect
	v := reflect.ValueOf(value)
	switch v.Kind() {
	case reflect.Ptr, reflect.Slice, reflect.Map, reflect.Chan, reflect.Func, reflect.Interface:
		Hassert(!v.IsNil(), "NewSome[T any](): value==nil")
	}
	sf := &Option[T]{val: &value}
	_ = IOption[T](sf)
	return sf
}

// NewNone - нет результата в ответе.
func NewNone[T any]() IOption[T] {
	return &Option[T]{
		val: nil,
	}
}

// IsVal - проверяет, есть ли значение.
func (sf *Option[T]) IsVal() bool {
	return sf.val != nil
}

// IsSome - проверяет, есть ли значение.
func (sf *Option[T]) IsNone() bool {
	return sf.val == nil
}

// Val - извлекает значение (паника, если None).
func (sf *Option[T]) Val() T {
	Hassert(sf.val != nil, "Option[T].Val(): val==nil!")
	return *sf.val
}

// ValOr - возвращает значение или дефолтное.
func (sf Option[T]) ValOr(defaultValue T) T {
	if sf.val == nil {
		return defaultValue
	}
	return *sf.val
}

// ValOrFn -- возвращает значение, если оно есть, или результат выполнения функции.
func (sf *Option[T]) ValOrFn(fn func() T) T {
	Hassert(fn != nil, "Result[T].UnwrapOrFn(): fn==nil")
	if sf.val == nil {
		return fn()
	}
	return *sf.val
}

// Hassert -- проверяет, что не пустое значение (с паникой).
func (sf *Option[T]) Hassert(msgFormat string, args ...any) T {
	Hassert(sf.val != nil, msgFormat, args...)
	return *sf.val
}

// Assert -- проверяет, что нет ошибки (с паникой только на локальном стенде).
func (sf *Option[T]) Assert(msgFormat string, args ...any) T {
	Assert(sf.val != nil, msgFormat, args...)
	return *sf.val
}