values

func Bool ¶

func Bool(v any) bool

Bool returns bool value

func Coalesce ¶

func Coalesce[M Measurable[any]](args ...M) M

Coalesce returns the first non-empty value

func Float32 ¶ added in v0.8.45

func Float32(v any) float32

Float32 will return the value as float32

func Float64 ¶ added in v0.8.45

func Float64(v any) float64

Float64 will return the value as float64

func IndentJSON ¶ added in v0.12.54

func IndentJSON(data string) string

IndentJSON indents a JSON string It will return the original string if it fails to indent This is useful for pretty printing JSON strings

func Int ¶

func Int(v any) int

Int will return the value as int

func Int64 ¶

func Int64(v any) int64

Int64 will return the value as int64

func IntSlice ¶ added in v0.15.77

func IntSlice(v any) []int

IntSlice returns slice of int values

func IsCollection ¶

func IsCollection(value any) bool

IsCollection returns true for slices and maps

func IsEmpty ¶ added in v0.15.81

func IsEmpty(value any) bool

IsEmpty checks if a value is considered empty

func IsMap ¶ added in v0.9.47

func IsMap(value any) bool

func IsSlice ¶ added in v0.9.47

func IsSlice(value any) bool

func JSON ¶ added in v0.4.1

func JSON(value any) string

JSON returns the value as a JSON string

func JSONIndent ¶ added in v0.12.54

func JSONIndent(value any) string

JSONIndent returns the value as a JSON string with indentation

func NumbersCoalesce ¶

func NumbersCoalesce[T ~int | ~int32 | ~uint | ~uint32 | ~int64 | ~uint64](items ...T) T

NumbersCoalesce returns the first value from the supplied list that is not 0, or 0 if there are no values that are not zero

func OrderedMapKeys ¶ added in v0.5.36

func OrderedMapKeys[K constraints.Ordered, V any](m map[K]V) []K

OrderedMapKeys returns ordered keys

func RangeOrderedMap ¶ added in v0.5.36

func RangeOrderedMap[K constraints.Ordered, V any](c map[K]V, f func(k K, v V) bool)

RangeOrderedMap range over ordered map

func Select ¶

func Select[T any](cond bool, a, b T) T

Select returns a if cond is true, otherwise b

func Shrink ¶ added in v0.15.81

func Shrink(value any) any

Shrink removes empty values recursively: - returns nil if value is empty - if it's a Map, then only non empty values are returned in a map, or nil - if it's a Slice, then only non empty values are returned.

// Example with nested structures
input := map[string]any{
	"users": []any{
		map[string]any{"name": "", "age": 0, "active": false},
		map[string]any{"name": "John", "age": 30, "active": true, "tags": []any{"", "admin"}},
		map[string]any{"name": "Jane", "age": 25, "tags": []any{"", "", ""}},
	},
	"config": map[string]any{
		"debug":   false,
		"timeout": 0,
		"host":    "localhost",
	},
	"empty_section": map[string]any{
		"a": "",
		"b": 0,
		"c": []any{},
	},
}

result := Shrink(input)
fmt.Printf("Result: %+v\n", result)

// Example with simple values
fmt.Printf("Empty string: %v\n", Shrink(""))
fmt.Printf("Non-empty string: %v\n", Shrink("hello"))
fmt.Printf("Zero int: %v\n", Shrink(0))
fmt.Printf("Non-zero int: %v\n", Shrink(42))
fmt.Printf("Empty slice: %v\n", Shrink([]any{}))
fmt.Printf("Slice with empty values: %v\n", Shrink([]any{"", 0, false}))
fmt.Printf("Slice with mixed values: %v\n", Shrink([]any{"", "hello", 0, 42}))

Output:

Result: map[config:map[host:localhost] users:[map[active:true age:30 name:John tags:[admin]] map[age:25 name:Jane]]]
Empty string: <nil>
Non-empty string: hello
Zero int: <nil>
Non-zero int: 42
Empty slice: <nil>
Slice with empty values: <nil>
Slice with mixed values: [hello 42]

func String ¶

func String(v any) string

String returns string value

func StringSlice ¶

func StringSlice(v any) []string

StringSlice returns slice of string values

func StringsCoalesce ¶

func StringsCoalesce(str ...string) string

StringsCoalesce returns the first non-empty string value

func Time ¶

func Time(v any) *time.Time

Time will return the value as Time

func UInt64 ¶

func UInt64(v any) uint64

UInt64 will return the value as uint64