slices

Documentation

Index

• func AnyFunc[S ~[]T, T any](s S, predicate func(val T) bool) bool
• func Concatenate[S ~[]E, E any](s ...S) S
• func Fill[T any](v T, n int) []T
• func Filter[S ~[]E, E any](s S, predicate func(e E) bool) S
• func Flatten[S ~[]E, E any](s []S) S
• func GroupByFunc[S ~[]E, E any, K comparable](s S, keyFunc func(E) K) map[K]S
• func GroupByFuncUnique[S ~[]E, E any, K comparable](s S, keyFunc func(E) K) map[K]E
• func Map[S ~[]E, E any, V any](s S, f func(E) V) []V
• func MapAndGroupByFuncs[S ~[]E, E any, K comparable, V any](s S, keyFunc func(E) K, mapFunc func(E) V) map[K][]V
• func Ones[T interfaces.Number](n int) []T
• func Partition[S ~[]E, E any](s S, n int) []S
• func PartitionToMaxLen[S ~[]E, E any](s S, maxLen int) []S
• func Pop[S ~[]E, E any](s *S) E
• func Repeat[T any](n int, vs ...T) []T
• func Shuffle[S ~[]E, E any](s ...S)
• func Subtract[T comparable](list []T, toRemove []T) []T
• func Unique[S ~[]E, E comparable](s S) S
• func Zeros[T any](n int) []T

Functions

func AnyFunc

func AnyFunc[S ~[]T, T any](s S, predicate func(val T) bool) bool

AnyFunc returns true if predicate(v) returns true for any value v in s.

func Concatenate

func Concatenate[S ~[]E, E any](s ...S) S

Concatenate returns a single slice created by concatenating the input slices.

func Fill

func Fill[T any](v T, n int) []T

Fill returns a slice T[] of length n with all elements equal to v.

func Filter

func Filter[S ~[]E, E any](s S, predicate func(e E) bool) S

func Flatten

func Flatten[S ~[]E, E any](s []S) S

Flatten merges a slice of slices into a single slice.

func GroupByFunc

func GroupByFunc[S ~[]E, E any, K comparable](s S, keyFunc func(E) K) map[K]S

GroupByFunc groups the elements e_1, ..., e_n of s into separate slices by keyFunc(e).

func GroupByFuncUnique

func GroupByFuncUnique[S ~[]E, E any, K comparable](s S, keyFunc func(E) K) map[K]E

GroupByFuncUnique returns a map keyFunc(e) to e for each element e in s.

func Map

func Map[S ~[]E, E any, V any](s S, f func(E) V) []V

Map Returns a slice consisting of the results of applying the given function to the elements of the input slice

func MapAndGroupByFuncs

func MapAndGroupByFuncs[S ~[]E, E any, K comparable, V any](s S, keyFunc func(E) K, mapFunc func(E) V) map[K][]V

MapAndGroupByFuncs groups the elements e_1, ..., e_n of s into separate slices by keyFunc(e) and then maps those resulting elements by mapFunc(e).

func Ones

func Ones[T interfaces.Number](n int) []T

Ones returns a slice T[] of length n with all elements equal to 1.

func Partition

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

Partition partitions the elements of s into n non-overlapping slices, such that some slices have len(s)/n+1 items and some len(s)/n items. Ordering is preserved, such that Flatten(Partition(s)) is equal to s.

func PartitionToMaxLen

func PartitionToMaxLen[S ~[]E, E any](s S, maxLen int) []S

PartitionToMaxLen partitions the elements of s into non-overlapping slices, such that each such slice contains at most maxLen elements.

func Pop

func Pop[S ~[]E, E any](s *S) E

Pop removes the last item from s and returns it. Calling pop on an empty slice causes a panic.

func Repeat

func Repeat[T any](n int, vs ...T) []T

Repeat returns a slice []T of length n*len(vs) consisting of n copies of vs.

func Shuffle

func Shuffle[S ~[]E, E any](s ...S)

Shuffle shuffles s.

func Subtract

func Subtract[T comparable](list []T, toRemove []T) []T

func Unique

func Unique[S ~[]E, E comparable](s S) S

Unique returns a copy of s with duplicate elements removed, keeping only the first occurrence.

func Zeros

func Zeros[T any](n int) []T

Zeros returns a slice T[] of length n with all elements equal to zero.