util

Documentation

Overview

util contains small standalone utility functions. This should have no dependencies on other server packages.

Index

• func CloneMapNonNil[M ~map[K]V, K comparable, V any](m M) M
• func FilterSlice[T any](in []T, predicate func(T) bool) []T
• func InverseMap[M ~map[K]V, K, V comparable](m M) map[V]K
• func MapConcurrent[IN any, OUT any](input []IN, mapper func(IN) (OUT, error)) ([]OUT, error)
• func Max[T constraints.Ordered](a, b T) T
• func MaxTime(a, b time.Time) time.Time
• func Min[T constraints.Ordered](a, b T) T
• func MinTime(a, b time.Time) time.Time
• func ReduceSlice[T any, A any](in []T, initializer A, reducer func(A, T) A) A
• func SliceHead[S ~[]E, E any](s S, n int) S
• func SliceTail[S ~[]E, E any](s S, n int) S
• func SortSlice[S ~[]E, E constraints.Ordered](slice S)

Functions

func CloneMapNonNil

func CloneMapNonNil[M ~map[K]V, K comparable, V any](m M) M

CloneMapNonNil is like maps.Clone except it can't return nil, it will return an empty map instead.

func FilterSlice

func FilterSlice[T any](in []T, predicate func(T) bool) []T

FilterSlice iterates over elements of a slice, returning a new slice of all elements predicate returns true for.

func InverseMap

func InverseMap[M ~map[K]V, K, V comparable](m M) map[V]K

InverseMap creates the inverse map, ie., for a key-value map, it builds the value-key map.

func MapConcurrent

func MapConcurrent[IN any, OUT any](input []IN, mapper func(IN) (OUT, error)) ([]OUT, error)

MapConcurrent concurrently maps a function over input and fails fast on error.

func Max

func Max[T constraints.Ordered](a, b T) T

Min returns the maximum of two comparable values.

func MaxTime

func MaxTime(a, b time.Time) time.Time

MinTime returns the later of two given time.Time

func Min

func Min[T constraints.Ordered](a, b T) T

Min returns the minimum of two comparable values.

func MinTime

func MinTime(a, b time.Time) time.Time

MinTime returns the earlier of two given time.Time

func ReduceSlice

func ReduceSlice[T any, A any](in []T, initializer A, reducer func(A, T) A) A

ReduceSlice reduces a slice using given reducer function and initial value.

func SliceHead

func SliceHead[S ~[]E, E any](s S, n int) S

SliceHead returns the first n elements of s. n may be greater than len(s).

func SliceTail

func SliceTail[S ~[]E, E any](s S, n int) S

SliceTail returns the last n elements of s. n may be greater than len(s).

func SortSlice

func SortSlice[S ~[]E, E constraints.Ordered](slice S)

SortSlice sorts the given slice of an ordered type. Sort is not guaranteed to be stable.