utils

Documentation

Index

• func Compare[T constraints.Ordered](x, y T) int
• func Detach(ctx context.Context) context.Context
• func Err(errors ...error) error
• func GetStacktrace(all bool) string
• func IsSortedAndUnique[T Sortable[T]](s []T) bool
• func IsSortedAndUniqueByHash[T ~[]byte](s []T) bool
• func IsSortedAndUniqueOrdered[T constraints.Ordered](s []T) bool
• func IsSortedBytes[T ~[]byte](s []T) bool
• func RandomBytes(n int) []byte
• func Sort[T Sortable[T]](s []T)
• func SortByHash[T ~[]byte](s []T)
• func Zero[T any]() T
• func ZeroSlice[T any](s []T)
• type Atomic
  • func (a *Atomic[T]) Get() T
  • func (a *Atomic[T]) Set(value T)
• type Sortable

Functions

func Compare

func Compare[T constraints.Ordered](x, y T) int

Compare returns

-1 if x is less than y,
 0 if x equals y,
 1 if x is greater than y.

TODO: Remove after updating to go1.21.

func Detach

func Detach(ctx context.Context) context.Context

func Err

func Err(errors ...error) error

func GetStacktrace

func GetStacktrace(all bool) string

func IsSortedAndUnique

func IsSortedAndUnique[T Sortable[T]](s []T) bool

Returns true iff the elements in [s] are unique and sorted.

func IsSortedAndUniqueByHash

func IsSortedAndUniqueByHash[T ~[]byte](s []T) bool

Returns true iff the elements in [s] are unique and sorted based by their hashes.

func IsSortedAndUniqueOrdered

func IsSortedAndUniqueOrdered[T constraints.Ordered](s []T) bool

Returns true iff the elements in [s] are unique and sorted.

func IsSortedBytes

func IsSortedBytes[T ~[]byte](s []T) bool

Returns true iff the elements in [s] are sorted.

func RandomBytes

func RandomBytes(n int) []byte

RandomBytes returns a slice of n random bytes Intended for use in testing

func Sort

func Sort[T Sortable[T]](s []T)

Sorts the elements of [s].

func SortByHash

func SortByHash[T ~[]byte](s []T)

Sorts the elements of [s] based on their hashes.

func Zero

func Zero[T any]() T

Returns a new instance of a T.

func ZeroSlice

func ZeroSlice[T any](s []T)

ZeroSlice sets all values of the provided slice to the type's zero value.

This can be useful to ensure that the garbage collector doesn't hold references to values that are no longer desired.

Types

type Atomic

type Atomic[T any] struct {
	// contains filtered or unexported fields
}

func (*Atomic[T]) Get

func (a *Atomic[T]) Get() T

func (*Atomic[T]) Set

func (a *Atomic[T]) Set(value T)

type Sortable

type Sortable[T any] interface {
	Compare(T) int
}