README
¶
ezpkg.io/slicez
Package slicez extends the standard library slices with additional functions.
Installation
go get -u ezpkg.io/slicez@v0.2.2
Examples
codes := slicez.MapFunc([]int{1, 2, 3}, func(i int) string {
return fmt.Sprintf("CODE(%d)", i)
})
fmt.Println(codes)
About ezpkg.io
As I work on various Go projects, I often find myself creating utility functions, extending existing packages, or developing packages to solve specific problems. Moving from one project to another, I usually have to copy or rewrite these solutions. So I created this repository to have all these utilities and packages in one place. Hopefully, you'll find them useful as well.
For more information, see the main repository.
Author
Documentation
¶
Index ¶
- func AppendSlice[S ~[]E, E any](s S, slices ...S) []E
- func AppendSliceTo[S ~*[]E, E any](s S, slices ...[]E) []E
- func AppendTo[S ~*[]E, E any](s S, items ...E) []E
- func Concat[S ~[]E, E any](slices ...S) []E
- func Exists[S ~[]E, E comparable](s S, item E) bool
- func ExistsFunc[S ~[]E, E any](s S, fn func(E) bool) bool
- func FilterFunc[S ~[]E, E any](s S, fn func(E) bool) (outs []E)
- func FilterMapFunc[S ~[]E, E any](s S, fn func(E) (E, bool)) (outs []E)
- func First[S ~[]E, E any](s S) (out E)
- func FirstFunc[S ~[]E, E any](s S, fn func(E) bool) (out E)
- func FirstN[S ~[]E, E any](s S, n int) (out []E)
- func Get[S ~[]E, E any](s S, n int) (out E)
- func GetFunc[S ~[]E, E any](s S, fn func(E) bool) (out E)
- func GetOr[S ~[]E, E any](s S, n int, fallback E) (out E)
- func GetOrFunc[S ~[]E, E any](s S, n int, fallback func() E) (out E)
- func GetX[S ~[]E, E any](s S, n int) (out E, ok bool)
- func IsUnique[S ~[]E, E comparable](s S) bool
- func IsUniqueFunc[S ~[]E, E any, K comparable](s S, fn func(E) K) bool
- func Last[S ~[]E, E any](s S) (out E)
- func LastFunc[S ~[]E, E any](s S, fn func(E) bool) (out E)
- func LastN[S ~[]E, E any](s S, n int) (out []E)
- func MapFilterFunc[S ~[]E, E, R any](s S, fn func(E) (R, bool)) (outs []R)
- func MapFunc[S ~[]E, E, R any](s S, fn func(E) R) []R
- func Prepend[S ~[]E, E any](s S, items ...E) []E
- func PrependTo[S ~*[]E, E any](s S, items ...E) []E
- func SortUnique[S ~[]E, E cmp.Ordered](s S) (out []E)
- func SortUniqueFunc[S ~[]E, E any, K cmp.Ordered](s S, fn func(E) K) (out []E)
- func Unique[S ~[]E, E comparable](s S) (out []E)
- func UniqueFunc[S ~[]E, E any, K comparable](s S, fn func(E) K) (out []E)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AppendSlice ¶ added in v0.1.1
func AppendSlice[S ~[]E, E any](s S, slices ...S) []E
AppendSlice appends multiple slices to the first slice.
func AppendSliceTo ¶ added in v0.1.2
func AppendSliceTo[S ~*[]E, E any](s S, slices ...[]E) []E
AppendSliceTo appends multiple slices to a slice pointer.
func AppendTo ¶ added in v0.1.2
func AppendTo[S ~*[]E, E any](s S, items ...E) []E
AppendTo appends multiple elements to a slice pointer.
func Concat ¶ added in v0.1.1
func Concat[S ~[]E, E any](slices ...S) []E
Concat combine multiple slices into a new slice.
func Exists ¶ added in v0.1.2
func Exists[S ~[]E, E comparable](s S, item E) bool
Exists returns true if the element exists in the slice. To get the index, use slices.Index or slices.IndexFunc.
func ExistsFunc ¶ added in v0.1.2
Exists returns true if the element exists in the slice. To get the index, use slices.Index or slices.IndexFunc.
func FilterFunc ¶
FilterFunc returns a new slice with elements that satisfy the function.
func FilterMapFunc ¶ added in v0.1.0
FilterMapFunc (or FilterMapFunc) returns a new slice with elements that satisfy the function, and maps them to a new type.
func Get ¶ added in v0.1.0
Get returns the element at index n. If n is negative, it returns from the end.
func GetFunc ¶ added in v0.1.2
GetFunc returns the element that satisfies the function. To get the index, use slices.Index or slices.IndexFunc.
func GetOr ¶ added in v0.1.0
GetOr returns the element at index n. If n is negative, it returns from the end. If n is out of range, it returns the fallback value.
func GetOrFunc ¶ added in v0.1.0
GetOrFunc returns the element at index n. If n is negative, it returns from the end. If n is out of range, it returns the result of the fallback function.
func GetX ¶ added in v0.1.0
GetX returns the element at index n. If n is negative, it returns from the end.
func IsUnique ¶ added in v0.1.2
func IsUnique[S ~[]E, E comparable](s S) bool
IsUnique returns true if all elements in the slice are unique.
func IsUniqueFunc ¶ added in v0.1.2
func IsUniqueFunc[S ~[]E, E any, K comparable](s S, fn func(E) K) bool
IsUniqueFunc returns true if all elements in the slice are unique based on the function.
func MapFilterFunc ¶
MapFilterFunc (or FilterMapFunc) returns a new slice with elements that satisfy the function, and maps them to a new type.
func MapFunc ¶
func MapFunc[S ~[]E, E, R any](s S, fn func(E) R) []R
MapFunc returns a new slice with elements mapped to a new type.
func Prepend ¶ added in v0.1.2
func Prepend[S ~[]E, E any](s S, items ...E) []E
Prepend appends multiple elements to the beginning of a slice.
func PrependTo ¶ added in v0.1.2
func PrependTo[S ~*[]E, E any](s S, items ...E) []E
PrependTo appends multiple elements to the beginning of a slice pointer.
func SortUnique ¶ added in v0.1.2
SortUnique modified content of the slice, and return the modified slice with unique elements, sorted.
func SortUniqueFunc ¶ added in v0.1.2
SortUniqueFunc modified content of the slice, and return the modified slice with unique elements, sorted based on the function.
func Unique ¶ added in v0.1.2
func Unique[S ~[]E, E comparable](s S) (out []E)
Unique returns a slice with unique elements. If the slice is already unique, it returns the original slice.
func UniqueFunc ¶ added in v0.1.2
func UniqueFunc[S ~[]E, E any, K comparable](s S, fn func(E) K) (out []E)
UniqueFunc returns a new slice with unique elements.
Types ¶
This section is empty.
Source Files