157 lines
3.4 KiB
Go
157 lines
3.4 KiB
Go
package util
|
|
|
|
import "io"
|
|
import "image/color"
|
|
|
|
// IndexOf returns the index of needle within haystack. If needle does not exist
|
|
// within haystack, it returns -1.
|
|
func IndexOf[T comparable] (haystack []T, needle T) int {
|
|
for index, test := range haystack {
|
|
if test == needle {
|
|
return index
|
|
}
|
|
}
|
|
return -1
|
|
}
|
|
|
|
// Remove removes an element from slice at index.
|
|
func Remove[T any] (slice []T, index int) []T {
|
|
return append(slice[:index], slice[index + 1:]...)
|
|
}
|
|
|
|
// Insert inserts an element into slice at index.
|
|
func Insert[T any] (slice []T, index int, element T) []T {
|
|
slice = append(slice[:index + 1], slice[index:]...)
|
|
slice[index] = element
|
|
return slice
|
|
}
|
|
|
|
// Transparent returns whether or not a color has transparency.
|
|
func Transparent (c color.Color) bool {
|
|
_, _, _, a := c.RGBA()
|
|
return a != 0xFFFF
|
|
}
|
|
|
|
// Set is a set of unique items, built on top of map.
|
|
type Set[T comparable] map[T] struct { }
|
|
|
|
// Empty returns true if there are no items in the set.
|
|
func (set Set[T]) Empty () bool {
|
|
return set == nil || len(set) == 0
|
|
}
|
|
|
|
// Has returns true if the set contains item.
|
|
func (set Set[T]) Has (item T) bool {
|
|
if set == nil {
|
|
return false
|
|
}
|
|
_, ok := set[item]
|
|
return ok
|
|
}
|
|
|
|
// Add adds an item to the set.
|
|
func (set Set[T]) Add (item T) {
|
|
set[item] = struct { } { }
|
|
}
|
|
|
|
// Pop removes the first accessible item from the set and returns it.
|
|
func (set Set[T]) Pop () (item T) {
|
|
for item := range set {
|
|
delete(set, item)
|
|
return item
|
|
}
|
|
return
|
|
}
|
|
|
|
// Memo holds a cached value.
|
|
type Memo[T any] struct {
|
|
cache T
|
|
valid bool
|
|
update func () T
|
|
}
|
|
|
|
// NewMemo creates a new Memo which will take its value from the specified
|
|
// update callback.
|
|
func NewMemo[T any] (update func () T) Memo[T] {
|
|
return Memo[T] {
|
|
update: update,
|
|
}
|
|
}
|
|
|
|
// Value returns the Memo's value, updating it if the current cached value is
|
|
// invalid.
|
|
func (this *Memo[T]) Value () T {
|
|
if !this.valid {
|
|
this.cache = this.update()
|
|
this.valid = true
|
|
}
|
|
return this.cache
|
|
}
|
|
|
|
// Invalidate marks the Memo's value as invalid, which will cause it to be
|
|
// updated the next time Value is called.
|
|
func (this *Memo[T]) Invalidate () {
|
|
var zero T
|
|
this.cache = zero
|
|
this.valid = false
|
|
}
|
|
|
|
// Cycler stores a value and an accompanying io.Closer. When the value is set,
|
|
// the closer associated with the previous value is closed.
|
|
type Cycler[T any] struct {
|
|
value T
|
|
closer io.Closer
|
|
}
|
|
|
|
// Value returns the cycler's value.
|
|
func (this *Cycler[T]) Value () T {
|
|
return this.value
|
|
}
|
|
|
|
// Set sets the value and associated closer, closing the previous one.
|
|
func (this *Cycler[T]) Set (value T, closer io.Closer) (err error) {
|
|
if this.closer != nil {
|
|
err = this.closer.Close()
|
|
}
|
|
this.value = value
|
|
this.closer = closer
|
|
return err
|
|
}
|
|
|
|
// Close closes the associated closer early.
|
|
func (this *Cycler[T]) Close () error {
|
|
err := this.closer.Close()
|
|
this.closer = nil
|
|
return err
|
|
}
|
|
|
|
// Optional is an optional value.
|
|
type Optional[T any] struct {
|
|
value T
|
|
exists bool
|
|
}
|
|
|
|
// Value returns the value and true if the value exists. If not, it returns the
|
|
// last set value and false.
|
|
func (this *Optional[T]) Value () (T, bool) {
|
|
return this.value, this.exists
|
|
}
|
|
|
|
// Set sets the value.
|
|
func (this *Optional[T]) Set (value T) {
|
|
this.value = value
|
|
this.exists = true
|
|
}
|
|
|
|
// Unset unsets the value.
|
|
func (this *Optional[T]) Unset () {
|
|
var zero T
|
|
this.value = zero
|
|
this.exists = false
|
|
}
|
|
|
|
// Exists returns if the value is currently set.
|
|
func (this *Optional[T]) Exists () bool {
|
|
return this.exists
|
|
}
|