valutil

package

v0.1.0 Latest Latest Go to latest Published: May 11, 2025 License: MIT Imports: 9 Imported by: 1

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/gomooth/utils

Links

Open Source Insights

README ¶

valutil 值处理工具

断言

valutil.IsNil(any) 判断任意类型的值是否为 Nil

类型强制转换

Boolean

valutil.Bool(any) 将任意值转成 bool，转换失败则返回 false
valutil.BoolWith(any, defaulted) 将任意值转成 bool，转换失败则返回 defaulted
valutil.MustBool(any) 将任意值转成 bool，转换失败则返回错误

转换规则如下：

如果传入值是 boolean，直接强制转换返回；
如果传入值是 string，则按以下规则转换：
- "true, yes, y" -> true
- "false, no, n" -> false
- "" -> false
- "0.0···001 ... 1 ... ∞" -> true
- "-∞ ... -1 ... -0.1 ... 0" -> false
- "other word" -> ERROR
如果传入值是数字，大于零返回 true，否则返回 false
- 0.0···001 ... 1 ... ∞ -> true
- -∞ ... -1 ... -0.1 ... 0 -> false
如果传入值是其他类型，则返回 ERROR

Integer

valutil.Int(any) 将任意值转成整数，转换失败则返回 false
valutil.IntWith(any, defaulted) 将任意值转成整数，转换失败则返回 defaulted
valutil.MustInt(any) 将任意值转成整数，转换失败则返回错误

规则如下：

如果输入值是数字，则直接转换；
如果输入值是 boolean，则 true 转为 1；false 转为 0；
如果输入值是 string，则按字符串转换规则，并支持以下字符转换：
- "true", "yes", "y" --> 1
- "false", "no", "n" --> 0

值和指针转换

valutil.Ptr(any) 返回值的指针
valutil.Val(ptr) 返回指针的值
valutil.SlicePtr 将值切片转换为指针切片
valutil.SliceVal 将指针切片转换为值切片

随机数

valutil.Rand(min, max) 生成 [min, max) 范围内的随机数
valutil.SecureRand(min, max) 生成 [min, max) 范围内的加密安全随机数
valutil.RandAlphanum(num) 生成 num 长度的随机字符串
valutil.RandSafeAlphanum(num) 生成 num 长度的易辨识的随机字符串。适合用于验证码、密码等需要人工识别的场景

Documentation ¶

Index ¶

Variables
func Bool[T any](value T) bool
func BoolWith[T any](value T, defaulted bool) bool
func Int[T any](value T) int
func IntWith[T any](value T, defaulted int) int
func IsNil[T any](v T) bool
func MustBool[T any](value T) (bool, error)
func MustInt[T any](value T) (int, error)
func Ptr[T any](v T) *T
func Rand[T number](min, max T) T
func RandAlphanum(n int) string
func RandSafeAlphanum(n int) string
func SecureRand[T number](min, max T) (T, error)
func SlicePtr[T any](s []T) []*T
func SliceVal[T any](s []*T) []T
func Val[T any](p *T) T

Constants ¶

This section is empty.

Variables ¶

View Source

var (
	ErrInvalidIntString  = errors.New("invalid integer string")
	ErrInvalidBoolString = errors.New("invalid boolean string")
	ErrUnsupportedType   = errors.New("unsupported type for conversion")
)

Functions ¶

func Bool ¶

func Bool[T any](value T) bool

Bool 将任意值转换为布尔值，失败则返回 false

func BoolWith ¶

func BoolWith[T any](value T, defaulted bool) bool

BoolWith 将任意值转换为布尔值，失败则返回 defaulted

func Int ¶

func Int[T any](value T) int

Int 将任意值转换为整型，失败则返回0

func IntWith ¶

func IntWith[T any](value T, defaulted int) int

IntWith 将任意值转换为整型，失败则返回 defaulted

func IsNil ¶

func IsNil[T any](v T) bool

IsNil 检查值是否为nil或指向nil 支持指针、slice、map、channel、func和interface类型

func MustBool ¶

func MustBool[T any](value T) (bool, error)

MustBool 将任意值转换为布尔值，如果无法转化则返回err 如果传入值是 boolean，直接强制转换返回；如果传入值是 string，则按以下规则转换：

"true, yes, y" -> true
"false, no, n, " -> false
"" -> false
"0.0···001 ... 1 ... ∞" -> true
"-∞ ... -1 ... -0.1 ... 0" -> false
"other word" -> ERROR

如果传入值是数字，大于零返回 true，否则返回 false

0.0···001 ... 1 ... ∞ -> true
-∞ ... -1 ... -0.1 ... 0 -> false

如果传入值是其他类型，则返回 ERROR

func MustInt ¶

func MustInt[T any](value T) (int, error)

MustInt 将任意值转换为整型如果输入值是数字，则直接转换；如果输入值是 boolean，则 true 转为 1；false 转为 0；如果输入值是 string，则按字符串转换规则否则抛出 ERROR

func Ptr ¶

func Ptr[T any](v T) *T

Ptr 返回值的指针

func Rand ¶

func Rand[T number](min, max T) T

Rand 生成 [min, max) 范围内的随机数

func RandAlphanum ¶

func RandAlphanum(n int) string

RandAlphanum 生成固定长度的随机字符串

func RandSafeAlphanum ¶

func RandSafeAlphanum(n int) string

RandSafeAlphanum 生成固定长度的随机易辨识的字符串适合用于验证码、密码等需要人工识别的场景

func SecureRand ¶

func SecureRand[T number](min, max T) (T, error)

SecureRand 生成 [min, max) 范围内的加密安全随机数

func SlicePtr ¶

func SlicePtr[T any](s []T) []*T

SlicePtr 将值切片转换为指针切片

func SliceVal ¶

func SliceVal[T any](s []*T) []T

SliceVal 将指针切片转换为值切片

func Val ¶

func Val[T any](p *T) T

Val 返回指针的值，如果指针为nil则返回类型零值

Types ¶

This section is empty.

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL