utils

Documentation

Index

• Constants
• Variables
• func Abs(v int64) int64
• func Bind(ptr any, tag string, input map[string]any) error
• func Bytes2Str(b []byte) string
• func CRC32(data string) uint32
• func CountLine(fileName string) (int, error)
• func FNV32a(data string) uint32
• func FastUuid() [24]byte
• func FastUuidStr() string
• func FillStruct(ptr any, data map[string]any)
• func FillStructByTag(ptr any, tag string, input map[string]any) (filled []string, err error)
• func Filter(params map[string]any, filters []string)
• func FindAllPrefixMatch(ss []string, prefix string) []string
• func FindFirst(n int, pred func(i int) bool) int
• func FindLast(n int, pred func(i int) bool) int
• func GetBool(v any) bool
• func GetByKind(kind reflect.Kind, v any) (result any)
• func GetByteArray(v any) []byte
• func GetDayRangeOfMonth(date time.Time) (firstDay, lastDay time.Time)
• func GetExternalIP() string
• func GetFloat32(v any) float32
• func GetFloat64(v any) float64
• func GetInt(v any) int
• func GetInt16(v any) int16
• func GetInt32(v any) int32
• func GetInt64(v any) int64
• func GetInt64Slices(v any) []int64
• func GetInt8(v any) int8
• func GetIntSlices(v any) []int
• func GetMonthsOfDayRange(layout string, beginDay, endDay time.Time) []string
• func GetPanicStack() string
• func GetStack(calldepth int) []byte
• func GetString(v any) string
• func GetTimeRangeOfDay(t time.Time) (begin, end time.Time)
• func GetUint(v any) uint
• func GetUint16(v any) uint16
• func GetUint32(v any) uint32
• func GetUint64(v any) uint64
• func GetUint64Slices(v any) []uint64
• func GetUint8(v any) uint8
• func IsAllLetters(input string) bool
• func IsAllNumberLetters(input string) bool
• func IsAllNumbers(input string) bool
• func IsErrClosing(err error) bool
• func IsFileExists(fileName string) (exists bool, err error)
• func IsType(value reflect.Value, expected reflect.Type) bool
• func JoinSlice(slice any, sep string) string
• func LocatePanic() string
• func Milliseconds(t time.Time) int64
• func ParseJSON(data []byte, ptr any) error
• func Rand(min, max int) int
• func RandString(n int, letterBytes string) string
• func RepeatWithSep(s string, sep string, count int) string
• func SetDefaults(ptr any) error
• func Split(str string, sep string) (r []string)
• func Str2Bytes(s string) []byte
• func StringJoin(params ...any) string
• func StringsToInterfaces(keys []string) []any
• func TimeInUTCOffset(t time.Time, utcOffset int) time.Time
• func TimeLocationOfUTCOffset(utcOffset int) *time.Location
• func ToCamel(s string) string
• func ToCamelLower(s string) string
• func ToJSON(v any) string
• func ToSnake(s string) string
• func TouchFile(fileName string) error
• func TrimUntil(s string, stop string) string
• type BindUnmarshaler

Constants

const (
	LettersAlphaNumber = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
	LettersNumber      = "0123456789"
	LettersAlpha       = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"
)

Variables

var BindSliceSep = ","

BindSliceSep the separator for parsing slice field

Functions

func Abs

func Abs(v int64) int64

Abs return the absolute value

func Bind

func Bind(ptr any, tag string, input map[string]any) error

Bind values to struct ptr

func Bytes2Str

func Bytes2Str(b []byte) string

Bytes2Str convert []byte to string without copy

func CRC32

func CRC32(data string) uint32

CRC32 return the CRC32 hash of string

func CountLine

func CountLine(fileName string) (int, error)

func FNV32a

func FNV32a(data string) uint32

FNV32a return the FNV32a hash of string

func FastUuid

func FastUuid() [24]byte

FastUuid generate a new UUID as []byte

func FastUuidStr

func FastUuidStr() string

FastUuidStr generate a new UUID as string

func FillStruct

func FillStruct(ptr any, data map[string]any)

FillStruct set the field value of ptr according data kv map.

func FillStructByTag

func FillStructByTag(ptr any, tag string, input map[string]any) (filled []string, err error)

FillStructByTag set the field value of struct s according

func Filter

func Filter(params map[string]any, filters []string)

Filter out keys in params

func FindAllPrefixMatch

func FindAllPrefixMatch(ss []string, prefix string) []string

FindAllPrefixMatch return all item in sorted string slice has the specified prefix.

func FindFirst

func FindFirst(n int, pred func(i int) bool) int

FindFirst return the first index that pred(i) is true. If not found, return n.

func FindLast

func FindLast(n int, pred func(i int) bool) int

FindLast return the last index that pred(i) is true. If not found, return -1.

func GetBool

func GetBool(v any) bool

GetBool convert interface to bool.

func GetByKind

func GetByKind(kind reflect.Kind, v any) (result any)

GetByKind convert interface to kind

func GetByteArray

func GetByteArray(v any) []byte

GetByteArray convert interface to byte slice.

func GetDayRangeOfMonth

func GetDayRangeOfMonth(date time.Time) (firstDay, lastDay time.Time)

GetDayRangeOfMonth [firstDay, lastDay]

func GetExternalIP

func GetExternalIP() string

GetExternalIP return the first available external ip address

func GetFloat32

func GetFloat32(v any) float32

GetFloat32 convert interface to float32.

func GetFloat64

func GetFloat64(v any) float64

GetFloat64 convert interface to float64.

func GetInt

func GetInt(v any) int

GetInt convert interface to int.

func GetInt16

func GetInt16(v any) int16

GetInt16 convert interface to int16.

func GetInt32

func GetInt32(v any) int32

GetInt32 convert interface to int32.

func GetInt64

func GetInt64(v any) int64

GetInt64 convert interface to int64.

func GetInt64Slices

func GetInt64Slices(v any) []int64

GetInt64Slices convert interface to []int64

func GetInt8

func GetInt8(v any) int8

GetInt8 convert interface to int8.

func GetIntSlices

func GetIntSlices(v any) []int

GetIntSlices convert interface to []int

func GetMonthsOfDayRange

func GetMonthsOfDayRange(layout string, beginDay, endDay time.Time) []string

GetMonthsOfDayRange return the month string of day range [beginDay, endDay]

func GetPanicStack

func GetPanicStack() string

GetPanicStack return the panic stack trace as string

func GetStack

func GetStack(calldepth int) []byte

GetStack return the stack trace of depth as []byte

func GetString

func GetString(v any) string

GetString convert interface to string.

func GetTimeRangeOfDay

func GetTimeRangeOfDay(t time.Time) (begin, end time.Time)

GetTimeRangeOfDay [begin, end)

func GetUint

func GetUint(v any) uint

GetUint convert interface to uint.

func GetUint16

func GetUint16(v any) uint16

GetUint16 convert interface to uint16.

func GetUint32

func GetUint32(v any) uint32

GetUint32 convert interface to uint32.

func GetUint64

func GetUint64(v any) uint64

GetUint64 convert interface to uint64.

func GetUint64Slices

func GetUint64Slices(v any) []uint64

GetUint64Slices convert interface to []uint64

func GetUint8

func GetUint8(v any) uint8

GetUint8 convert interface to uint8.

func IsAllLetters

func IsAllLetters(input string) bool

IsAllLetters return true if input contains only letters.

func IsAllNumberLetters

func IsAllNumberLetters(input string) bool

IsAllNumberLetters return true if input contains only numbers or letters.

func IsAllNumbers

func IsAllNumbers(input string) bool

IsAllNumbers return true if input contains only numbers.

func IsErrClosing

func IsErrClosing(err error) bool

IsErrClosing return true if err indicates socket is closing

func IsFileExists

func IsFileExists(fileName string) (exists bool, err error)

func IsType

func IsType(value reflect.Value, expected reflect.Type) bool

IsType check type

func JoinSlice

func JoinSlice(slice any, sep string) string

JoinSlice join the slice to string with separator `sep`

func LocatePanic

func LocatePanic() string

LocatePanic return the panic location

func Milliseconds

func Milliseconds(t time.Time) int64

Milliseconds return the milliseconds of time

func ParseJSON

func ParseJSON(data []byte, ptr any) error

ParseJSON parse json with dynamic field parse support

func Rand

func Rand(min, max int) int

Rand return an random number between [min, max)

func RandString

func RandString(n int, letterBytes string) string

RandString return a random string of length n

func RepeatWithSep

func RepeatWithSep(s string, sep string, count int) string

RepeatWithSep repeat the `s` `count` times, and separated by `sep`

func SetDefaults

func SetDefaults(ptr any) error

SetDefaults set the default value by tag `default:"value"`

func Split

func Split(str string, sep string) (r []string)

Split the string. if empty return an empty slice instead of nil

func Str2Bytes

func Str2Bytes(s string) []byte

Str2Bytes convert string to []byte without copy

func StringJoin

func StringJoin(params ...any) string

StringJoin join slice to single string

func StringsToInterfaces

func StringsToInterfaces(keys []string) []any

StringsToInterfaces convert to []string to []interface{}

func TimeInUTCOffset

func TimeInUTCOffset(t time.Time, utcOffset int) time.Time

TimeInUTCOffset return time in specified utc offset

func TimeLocationOfUTCOffset

func TimeLocationOfUTCOffset(utcOffset int) *time.Location

TimeLocationOfUTCOffset return the time.Location of utc offset

func ToCamel

func ToCamel(s string) string

ToCamel returns a string converted from snake case to uppercase

func ToCamelLower

func ToCamelLower(s string) string

ToCamelLower returns a string converted from snake case to lowercase

func ToJSON

func ToJSON(v any) string

ToJSON return json encoded string of interface.

func ToSnake

func ToSnake(s string) string

ToSnake converts a given string to snake case

func TouchFile

func TouchFile(fileName string) error

func TrimUntil

func TrimUntil(s string, stop string) string

TrimUntil trim the prefix until find the stop character

Types

type BindUnmarshaler

type BindUnmarshaler interface {
	UnmarshalBind(value string) error
}

BindUnmarshaler the bind unmarshal interface