maps

func CopyTo ¶ added in v0.4.28

func CopyTo[Map ~map[K]V, K comparable, V any](src Map, dist Map)

将源字典中的所有键值对复制到目标字典中。

入参：

• src: 源字典。
• dist: 目标字典。

func DeepReplaceValue ¶ added in v0.4.27

func DeepReplaceValue(dict map[string]any, oldStr, newStr string) map[string]any

在字典中递归地替换指定的字符串的值。 注意该函数会修改原始的字典。

入参：

• dict: 字典。
• oldStr：需要替换的字符串。
• newStr：替换后的字符串。

出参：

• dict: 替换后的字典。

func DeepReplaceValueUnsafe ¶ added in v0.4.27

func DeepReplaceValueUnsafe(dict any, oldStr, newStr string) any

与 DeepReplaceValue 类似，但入参类型为 `any`。

func GetBool ¶

func GetBool(dict map[string]any, key string) bool

以布尔形式从字典中获取指定键的值。

入参：

• dict: 字典。
• key: 键。

出参：

• 字典中键对应的值。如果指定键不存在、或者值的类型不是布尔，则返回 false。

func GetInt ¶ added in v0.4.4

func GetInt(dict map[string]any, key string) int

以整数形式从字典中获取指定键的值。

入参：

• dict: 字典。
• key: 键。

出参：

• 字典中键对应的值。如果指定键不存在、或者值的类型不是整数，则返回 0。

func GetInt32 ¶

func GetInt32(dict map[string]any, key string) int32

以 32 位整数形式从字典中获取指定键的值。

入参：

• dict: 字典。
• key: 键。

出参：

• 字典中键对应的值。如果指定键不存在、或者值的类型不是 32 位整数，则返回 0。

func GetInt64 ¶

func GetInt64(dict map[string]any, key string) int64

以 64 位整数形式从字典中获取指定键的值。

入参：

• dict: 字典。
• key: 键。

出参：

• 字典中键对应的值。如果指定键不存在、或者值的类型不是 64 位整数，则返回 0。

func GetKVMap ¶

func GetKVMap[V any](dict map[string]any, key string) map[string]V

以 `map[string]V` 形式从字典中获取指定键的值。

入参：

• dict: 字典。
• key: 键。

出参：

• 字典中键对应的 `map[string]V` 对象。

func GetKVMapAny ¶

func GetKVMapAny(dict map[string]any, key string) map[string]any

以 `map[string]any` 形式从字典中获取指定键的值。

入参：

• dict: 字典。
• key: 键。

出参：

• 字典中键对应的 `map[string]any` 对象。

func GetOrDefaultBool ¶

func GetOrDefaultBool(dict map[string]any, key string, defaultValue bool) bool

以布尔形式从字典中获取指定键的值。

入参：

• dict: 字典。
• key: 键。
• defaultValue: 默认值。

出参：

• 字典中键对应的值。如果指定键不存在、或者值的类型不是布尔，则返回默认值。

func GetOrDefaultInt ¶ added in v0.4.4

func GetOrDefaultInt(dict map[string]any, key string, defaultValue int) int

以整数形式从字典中获取指定键的值。

入参：

• dict: 字典。
• key: 键。
• defaultValue: 默认值。

出参：

• 字典中键对应的值。如果指定键不存在、值的类型不是整数、或者值为零值，则返回默认值。

func GetOrDefaultInt32 ¶

func GetOrDefaultInt32(dict map[string]any, key string, defaultValue int32) int32

以 32 位整数形式从字典中获取指定键的值。

入参：

• dict: 字典。
• key: 键。
• defaultValue: 默认值。

出参：

• 字典中键对应的值。如果指定键不存在、值的类型不是 32 位整数、或者值为零值，则返回默认值。

func GetOrDefaultInt64 ¶

func GetOrDefaultInt64(dict map[string]any, key string, defaultValue int64) int64

以 64 位整数形式从字典中获取指定键的值。

入参：

• dict: 字典。
• key: 键。
• defaultValue: 默认值。

出参：

• 字典中键对应的值。如果指定键不存在、值的类型不是 64 位整数、或者值为零值，则返回默认值。

func GetOrDefaultString ¶

func GetOrDefaultString(dict map[string]any, key string, defaultValue string) string

以字符串形式从字典中获取指定键的值。

入参：

• dict: 字典。
• key: 键。
• defaultValue: 默认值。

出参：

• 字典中键对应的值。如果指定键不存在、值的类型不是字符串、或者值为零值，则返回默认值。

func GetOrDefaultStringsBySplit ¶ added in v0.4.28

func GetOrDefaultStringsBySplit(dict map[string]any, key string, sep string, defaultValue []string) []string

以字符串形式从字典中获取指定键的值，并按指定分隔符拆分。

入参：

• dict: 字典。
• key: 键。
• defaultValue: 默认值。

出参：

• 字典中键对应的值。如果指定键不存在、值的类型不是字符串、或者值为零值，则返回默认值。

func GetString ¶

func GetString(dict map[string]any, key string) string

以字符串形式从字典中获取指定键的值。

入参：

• dict: 字典。
• key: 键。

出参：

• 字典中键对应的值。如果指定键不存在、或者值的类型不是字符串，则返回空字符串。

func GetStringsBySplit ¶ added in v0.4.28

func GetStringsBySplit(dict map[string]any, key string, sep string) []string

以字符串形式从字典中获取指定键的值，并按指定分隔符拆分。

入参：

• dict: 字典。
• key: 键。

出参：

• 字典中键对应的值。如果指定键不存在、或者值的类型不是字符串，则返回空字符串切片。

func Keys ¶ added in v0.4.28

func Keys[Map ~map[K]V, K comparable, V any](dict Map) []K

获取字典中的所有键组成的切片。

入参：

• dict: 字典。

出参：

• keys: 字典中的所有键组成的切片。

func Populate ¶

func Populate(dict map[string]any, output any) error

将字典填充到指定类型的结构体。 与 [json.Unmarshal] 类似，但传入的是一个 [map[string]any] 对象而非 JSON 格式的字符串。

入参：

• dict: 字典。
• output: 结构体指针。

出参：

• 错误信息。如果填充失败，则返回错误信息。