sliceutil

README

sliceutil

The package contains various helpers to interact with slices

Documentation

Index

• func Contains[T comparable](inputSlice []T, element T) bool
• func ContainsItems[T comparable](s1 []T, s2 []T) bool
• func Dedupe[T comparable](inputSlice []T) (result []T)
• func Diff[V comparable](s1, s2 []V) (extraS1, extraS2 []V)
• func ElementsMatch[V comparable](s1, s2 []V) bool
• func Equal[T comparable](s1, s2 []T) bool
• func FirstNonZero[T comparable](inputs []T) (T, bool)
• func IsEmpty[V comparable](s []V) bool
• func Merge[V comparable](ss ...[]V) []V
• func MergeItems[V comparable](items ...V) []V
• func PickRandom[T any](v []T) T
• func PruneEmptyStrings(v []string) []string
• func PruneEqual[T comparable](inputSlice []T, equalTo T) (r []T)
• func ToInt(s []string) ([]int, error)

Functions

func Contains

func Contains[T comparable](inputSlice []T, element T) bool

Contains if a slice contains an element

func ContainsItems

func ContainsItems[T comparable](s1 []T, s2 []T) bool

ContainsItems checks if s1 contains s2

func Dedupe

func Dedupe[T comparable](inputSlice []T) (result []T)

Dedupe removes duplicates from a slice of elements preserving the order

func Diff

func Diff[V comparable](s1, s2 []V) (extraS1, extraS2 []V)

Diff calculates the extra elements between two sequences

func ElementsMatch

func ElementsMatch[V comparable](s1, s2 []V) bool

ElementsMatch asserts that the specified listA(array, slice...) is equal to specified listB(array, slice...) ignoring the order of the elements. If there are duplicate elements, the number of appearances of each of them in both lists should match.

func Equal

func Equal[T comparable](s1, s2 []T) bool

Equal checks if the items of two slices are equal respecting the order

func FirstNonZero

func FirstNonZero[T comparable](inputs []T) (T, bool)

FirstNonZero function takes a slice of comparable type inputs, and returns the first non-zero element in the slice along with a boolean value indicating if a non-zero element was found or not.

func IsEmpty

func IsEmpty[V comparable](s []V) bool

IsEmpty checks if the slice has length zero

func Merge

func Merge[V comparable](ss ...[]V) []V

Merge and dedupe multiple items

func MergeItems

func MergeItems[V comparable](items ...V) []V

Merge and dedupe multiple items into a

func PickRandom

func PickRandom[T any](v []T) T

PickRandom item from a slice of elements

func PruneEmptyStrings

func PruneEmptyStrings(v []string) []string

PruneEmptyStrings from the slice

func PruneEqual

func PruneEqual[T comparable](inputSlice []T, equalTo T) (r []T)

PruneEqual removes items from the slice equal to the specified value

func ToInt

func ToInt(s []string) ([]int, error)

ToInt converts a slice of strings to a slice of ints