5.8 KiB
5.8 KiB
cast > cast.go
// If 泛型三元表达式
func If[T any](condition bool, trueVal, falseVal T) T
// In 泛型包含判断
func In[T comparable](arr []T, val T) bool
// As 忽略错误，返回零值 (消除摩擦)
func As[T any](v T, err error) T
func RealValue(v reflect.Value) reflect.Value
// --- Core Cast Logic ---
var (
timeType = reflect.TypeOf(time.Time{})
)
// To 深度转换 (支持基础类型、Slice、Map、Struct 及 JSON 自动转换，零摩擦模式)
func To[T any](v any) T
// Convert 深度转换 (支持基础类型、Slice、Map、Struct 及 JSON 自动转换，原地更新)
func Convert(dst, src any)
func performRecursiveTo(src, dst reflect.Value)
// 内部递归助手 (零分配/高性能设计)
func recursiveMapToStruct(src, dst reflect.Value)
func recursiveStructToStruct(src, dst reflect.Value)
func recursiveMapToMap(src, dst reflect.Value)
func recursiveStructToMap(src, dst reflect.Value)
func recursiveSliceToMap(src, dst reflect.Value)
func recursiveSliceToSlice(src, dst reflect.Value)
func ToTime(v any, format string) time.Time
func reflectCast(value any, t reflect.Type) reflect.Value
func reflectCastE(value any, t reflect.Type) (reflect.Value, error)
func ToInt64E(v any) (int64, error)
func ToUint64E(v any) (uint64, error)
func ToFloat64E(v any) (float64, error)
func isJSONText(v any) bool
cast > time.go
// TimeZone 定义了特定时区上下文下的时间操作
type TimeZone struct {
loc *time.Location
}
// NewTimeZone 创建一个时区上下文
func NewTimeZone(loc *time.Location) *TimeZone
// DefaultTimeZone 全局默认时区，默认为本地时区
var DefaultTimeZone = NewTimeZone(time.Local)
// SetDefaultTimeZone 修改全局默认时区
func SetDefaultTimeZone(loc *time.Location)
// 在包级别预先初始化 Replacer，0 额外分配
var timeFormatReplacer = strings.NewReplacer(
"YYYY", "2006", "YY", "06",
"MM", "01", "M", "1",
"DD", "02", "D", "2",
"HH", "15", "hh", "03", "h", "3",
"mm", "04", "ss", "05",
"a", "pm", "A", "PM",
"ZZ", "-0700", "Z", "-07:00",
)
// ParseTime 将任意类型转换为 time.Time。
// 支持：time.Time, 时间戳 (秒/毫秒/微秒/纳秒), RFC3339, JS 格式, 中文格式等。
// 转换失败返回零值 time.Time{} 以保持 cast 的静默风格。
func (tz *TimeZone) ParseTime(v any) time.Time
var cnDateRegex = regexp.MustCompile(`(\d{2,4})?年?(\d{1,2})月(\d{1,2})日`)
var cnTimeRegex = regexp.MustCompile(`(上午|下午)?(\d{1,2})(?:时|点|：)(\d{1,2})(?:分|：)(\d{1,2})?秒?`)
func (tz *TimeZone) parseCN(str string) time.Time
// ParseTime 将任意类型转换为 time.Time。
func ParseTime(v any) time.Time
// FormatTime 格式化时间。
// layout 支持: YYYY-MM-DD HH:mm:ss, YYYY/MM/DD, HH:mm 等直观格式。
func (tz *TimeZone) FormatTime(layout string, v any) string
// FormatTime 格式化时间。
func FormatTime(layout string, v any) string
// AddTime 时间加减 DSL。
// 格式如: "+1Y-2M+3D", "+1h30m", "-1s"。
// 单位支持: Y (年), M (月), D (天), h, m, s, ms, us, ns。
func (tz *TimeZone) AddTime(expr string, v any) time.Time
// AddTime 时间加减 DSL。
func AddTime(expr string, v any) time.Time
// Now 获取当前时间
func (tz *TimeZone) Now() time.Time
// Location 获取当前时区
func (tz *TimeZone) Location() *time.Location
// Now 获取当前时间
func Now() time.Time
// DescribeDuration 将时长转化为自然语言描述，例如 "1h 1m 1s"
func (tz *TimeZone) DescribeDuration(d time.Duration) string
// DescribeDuration 将时长转化为自然语言描述
func DescribeDuration(d time.Duration) string
cast > json_encoder.go
var (
bufferPool = sync.Pool{
New: func() any {
return new(bytes.Buffer)
},
}
encoderStructCache sync.Map
)
type encoderFieldDescriptor struct {
index int
name string
isAnonymous bool
isTime bool
timeFormat string
keepKey bool
}
type encoderStructDescriptor struct {
fields []encoderFieldDescriptor
}
type fastEncoder struct {
buffer *bytes.Buffer
desensitizeKeys map[string]bool
}
func (encoder *fastEncoder) encode(value any) error
func (encoder *fastEncoder) encodeValue(reflectValue reflect.Value, path string) error
func (encoder *fastEncoder) writeTime(t time.Time, format string)
func (encoder *fastEncoder) encodeSlice(reflectValue reflect.Value, path string) error
func (encoder *fastEncoder) encodeMap(reflectValue reflect.Value, path string) error
func getEncoderStructDescriptor(reflectType reflect.Type) *encoderStructDescriptor
func (encoder *fastEncoder) encodeStruct(reflectValue reflect.Value, path string) error
func (encoder *fastEncoder) encodeStructFields(reflectValue reflect.Value, path string, first *bool) error
func (encoder *fastEncoder) writeString(str string)
// 导出函数
func fastToJSONBytes(value any, desensitizeKeys ...string) ([]byte, error)
cast > json_decoder.go
var (
structFieldMapCache sync.Map
)
type decoderFieldDescriptor struct {
index int
isTime bool
timeFormat string
normalized string
}
type decoderStructDescriptor struct {
exactMatches map[string]decoderFieldDescriptor
fields []decoderFieldDescriptor
}
type decoder struct {
data []byte
pos int
}
func (d *decoder) skipWhitespace()
func (d *decoder) decode(value any) error
func (d *decoder) decodeValue(reflectValue reflect.Value, timeFormat string) error
func (d *decoder) skipValue() error
// Frictionless Logic
func getDecoderFieldMap(reflectType reflect.Type) *decoderStructDescriptor
func matchField(key string, descriptor *decoderStructDescriptor) (int, bool, string, bool)
func normalizeEqual(raw string, normalized string) bool
func normalizeKey(str string) string
func fastUnmarshalJSONBytes(data []byte, value any) error