Documentation
¶
Index ¶
- func All[T any](s []T, f func(T) bool) bool
- func Any[T any](s []T, f func(T) bool) bool
- func Collect[S any, T any](s []S, f func(S) T) (r []T)
- func Contains[T comparable](s []T, x T) bool
- func Equal[T comparable](s []T, t []T) bool
- func EqualBy[S any, T any](s []S, t []T, f func(S, T) bool) bool
- func First[T any](s []T, n uint) []T
- func Last[T any](s []T, n uint) []T
- func None[T any](s []T, f func(T) bool) bool
- func Remove[T comparable](s []T, x T) (r []T)
- func Reverse[T any](s []T) (r []T)
- func Sort[T Orderable](s []T) []T
- func SortBy[T any](s []T, f func(x, y T) bool) (r []T)
- func Uniq[T comparable](s []T) (r []T)
- func UniqBy[S any, T comparable](s []S, f func(S) T) (r []S)
- type Orderable
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func All ¶ added in v0.2.0
Report whether the given boolean function evaluates to true for all elements of the given slice. Returns true for nil or empty slices. All(s, f) is equivalent to !Any(s, !f) and None(s, !f).
func Any ¶ added in v0.2.0
Report whether the given boolean function evaluates to true for at least one element of the given slice. Returns false for nil or empty slices. Any(s, f) is equivalent to !All(s, !f) and !None(s, f).
func Collect ¶ added in v0.1.1
Collect (map) slice through given function. If the input is nil, it will return nil; if the input is empty, it will return an empty slice. Otherweise, it will return return a slice of the same length as the input slice, containing the elements mapped through the provided function f.
func Equal ¶
func Equal[T comparable](s []T, t []T) bool
Compare two slices of comparable elements. Slices with different length are never equal. Empty and nil slices are always equal (in particular, comparing an empty with a nil slice yields true). Otherwise, the two slices are equal, if all their elements are equal by means of the == operator.
func EqualBy ¶
Compare two slices by a given equality function. Slices with different length are never equal. Empty and nil slices are always equal (in particular, comparing an empty with a nil slice yields true). Otherwise, the two slices are equal if all their elements are equal by means of the provided equality function.
func First ¶ added in v0.1.8
Get first n elements of a slice. If n is greater than the length of the slice, the input slice will be returned. If the input is nil, it will return nil; otherwise, if the result is empty, it will return an empty slice.
func Last ¶ added in v0.1.8
Get last n elements of a slice. If n is greater than the length of the slice, the input slice will be returned. If the input is nil, it will return nil; otherwise, if the result is empty, it will return an empty slice.
func None ¶ added in v0.2.0
Report whether the given boolean function evaluates to true for none of the elements of the given slice. Equivalently: evaluates to false for all of the elements of the given slice. Returns true for nil or empty slices. None(s, f) is equivalent to !Any(s, f) and All(s, !f).
func Remove ¶
func Remove[T comparable](s []T, x T) (r []T)
Remove all occurrences of given element from slice (and return new slice; old slice remains unchanged). If the input is nil, it will return nil; otherwise, if the result is empty, it will return an empty slice.
func Reverse ¶
func Reverse[T any](s []T) (r []T)
Reverse slice. If the input is nil, it will return nil; otherwise, if the input is empty, it will return an empty slice.
func Sort ¶
func Sort[T Orderable](s []T) []T
Sort slice of orderable elements. If the input is nil, it will return nil; otherwise, if the input is empty, it will return an empty slice.
func SortBy ¶
Sort slice by given comparator function. If the input is nil, it will return nil; otherwise, if the input is empty, it will return an empty slice. The comparator function f(x,y) must return true if x is larger than y, and false if x is smaller than y; the return value in case of equality does not matter (may be true or false).
func Uniq ¶
func Uniq[T comparable](s []T) (r []T)
Remove duplicates from slice of comparable elements. Preserves order. The first occurrence of an element will be kept, the other occurrences will be dropped. If the input is nil, it will return nil; otherwise, if the input is empty, it will return an empty slice.
func UniqBy ¶ added in v0.2.0
func UniqBy[S any, T comparable](s []S, f func(S) T) (r []S)
Remove duplicates from slice by given mapper function. Two elements are considered equal if the mapper function returns the same value for them. Preserves order. The first occurrence of an element will be kept, the other occurrences will be dropped. If the input is nil, it will return nil; otherwise, if the input is empty, it will return an empty slice.
Source Files