README.md

GoG (Go Generics)

GoG is a Go library with useful generic functions and types.

Since the introduction of generics in Go 1.18, a number of useful and reusable data structures, algorithms and utility functions are now possible. This library attempts to cover some of the most common use cases.

It avoids duplicating functions that are already provided by slices and maps.

For a complete list on available functions and types, check the godoc documentation for this project:

• gog - general utility functions
• gog/ds - data structures
• gog/filter - data filtering
• gog/opt - optional fields and types

Examples

Converting slice values from one type to another:

source := []int{1, 2, 3, 4}
target := gog.Map(source, func(item int) float64 {
  return float64(item) / 2.0
})
// target = []float64{0.5, 1.0, 1.5, 2.0}

Removing duplicate items in a slice:

source := []string{"john", "bill", "eric", "john", "max", "eric"}
target := gog.Dedupe(source)
// target = []string{"john", "bill", "eric", "max"}

Finding an item in a slice:

source := []string{"user 01", "user 02", "user 05", "user 33"}
foundItem, ok := gog.FindFunc(source, func(item string) bool {
  return strings.Contains(item, "02")
})
// ok = true
// foundItem = "user 02"

Selecting specific slice items:

source := []int{1, 2, 3, 4}
target := gog.Select(source, func(item int) bool {
  return item % 2 == 0
})
// target = []int{2, 4}