字典类型-方法介绍 - 图1提示

以下常用方法列表,文档更新可能滞后于代码新特性,更多的方法及示例请参考代码文档: https://pkg.go.dev/github.com/gogf/gf/v2/container/gmap

New

  • 说明: New 创建并返回一个空的 AnyAnyMap。参数 safe 用于指定是否使用并发安全的 map,默认情况下为 false

  • 格式:

  1. New(safe ...bool) *Map
  • 示例:
  1. func ExampleNew() {
  2. m := gmap.New()
  3. // Add data.
  4. m.Set("key1", "val1")
  5. // Print size.
  6. fmt.Println(m.Size())
  7. addMap := make(map[interface{}]interface{})
  8. addMap["key2"] = "val2"
  9. addMap["key3"] = "val3"
  10. addMap[1] = 1
  11. fmt.Println(m.Values())
  12. // Batch add data.
  13. m.Sets(addMap)
  14. // Gets the value of the corresponding key.
  15. fmt.Println(m.Get("key3"))
  16. // Get the value by key, or set it with given key-value if not exist.
  17. fmt.Println(m.GetOrSet("key4", "val4"))
  18. // Set key-value if the key does not exist, then return true; or else return false.
  19. fmt.Println(m.SetIfNotExist("key3", "val3"))
  20. // Remove key
  21. m.Remove("key2")
  22. fmt.Println(m.Keys())
  23. // Batch remove keys.
  24. m.Removes([]interface{}{"key1", 1})
  25. fmt.Println(m.Keys())
  26. // Contains checks whether a key exists.
  27. fmt.Println(m.Contains("key3"))
  28. // Flip exchanges key-value of the map, it will change key-value to value-key.
  29. m.Flip()
  30. fmt.Println(m.Map())
  31. // Clear deletes all data of the map.
  32. m.Clear()
  33. fmt.Println(m.Size())
  34. // May Output:
  35. // 1
  36. // [val1]
  37. // val3
  38. // val4
  39. // false
  40. // [key4 key1 key3 1]
  41. // [key4 key3]
  42. // true
  43. // map[val3:key3 val4:key4]
  44. // 0
  45. }

NewFrom

  • 说明: NewFrom 使用给定 map 的数据创建并返回 AnyAnyMap

  • 注意:入参 map 将被设置为底层数据映射(无深度拷贝),在外部更改 map 时,可能会同时出现一些安全问题。可选参数 safe 指定是否在并发安全中使用此结构,默认情况下为 false

  • 格式:

  1. NewFrom(data map[interface{}]interface{}, safe ...bool) *Map
  • 示例:
  1. func ExampleNewFrom() {
  2. m := gmap.New()
  3. m.Set("key1", "val1")
  4. fmt.Println(m)
  5. n := gmap.NewFrom(m.MapCopy(), true)
  6. fmt.Println(n)
  7. // Output:
  8. // {"key1":"val1"}
  9. // {"key1":"val1"}
  10. }

Iterator

  • 说明: Iterator 使用自定义回调函数 f 以只读方式迭代 hashmap。如果 f 返回 true,则继续迭代,返回 false 则停止。

  • 格式:

  1. Iterator(f func(k interface{}, v interface{}) bool)
  • 示例:
  1. func ExampleAnyAnyMap_Iterator() {
  2. m := gmap.New()
  3. for i := 0; i < 10; i++ {
  4. m.Set(i, i*2)
  5. }
  6. var totalKey, totalValue int
  7. m.Iterator(func(k interface{}, v interface{}) bool {
  8. totalKey += k.(int)
  9. totalValue += v.(int)
  10. return totalKey < 10
  11. })
  12. fmt.Println("totalKey:", totalKey)
  13. fmt.Println("totalValue:", totalValue)
  14. // May Output:
  15. // totalKey: 11
  16. // totalValue: 22
  17. }

Clone

  • 说明: Clone 返回一个新的 AnyAnyMap,其中包含当前 map 数据的副本。

  • 格式:

  1. Clone(safe ...bool) *AnyAnyMap
  • 示例:
  1. func ExampleAnyAnyMap_Clone() {
  2. m := gmap.New()
  3. m.Set("key1", "val1")
  4. fmt.Println(m)
  5. n := m.Clone()
  6. fmt.Println(n)
  7. // Output:
  8. // {"key1":"val1"}
  9. // {"key1":"val1"}
  10. }

Map

  • 说明: Map 返回底层数据 map

  • 注意:如果在并发安全中,它将返回底层数据的副本,否则返回指向底层数据的指针。

  • 格式:

  1. Map() map[interface{}]interface{}
  • 示例:
  1. func ExampleAnyAnyMap_Map() {
  2. // non concurrent-safety, a pointer to the underlying data
  3. m1 := gmap.New()
  4. m1.Set("key1", "val1")
  5. fmt.Println("m1:", m1)
  6. n1 := m1.Map()
  7. fmt.Println("before n1:", n1)
  8. m1.Set("key1", "val2")
  9. fmt.Println("after n1:", n1)
  10. // concurrent-safety, copy of underlying data
  11. m2 := gmap.New(true)
  12. m2.Set("key1", "val1")
  13. fmt.Println("m1:", m2)
  14. n2 := m2.Map()
  15. fmt.Println("before n2:", n2)
  16. m2.Set("key1", "val2")
  17. fmt.Println("after n2:", n2)
  18. // Output:
  19. // m1: {"key1":"val1"}
  20. // before n1: map[key1:val1]
  21. // after n1: map[key1:val2]
  22. // m1: {"key1":"val1"}
  23. // before n2: map[key1:val1]
  24. // after n2: map[key1:val1]
  25. }

MapCopy

  • 说明: MapCopy 返回 map 的数据的副本。

  • 格式:

  1. MapCopy() map[interface{}]interface{}
  • 示例:
  1. func ExampleAnyAnyMap_MapCopy() {
  2. m := gmap.New()
  3. m.Set("key1", "val1")
  4. m.Set("key2", "val2")
  5. fmt.Println(m)
  6. n := m.MapCopy()
  7. fmt.Println(n)
  8. // Output:
  9. // {"key1":"val1","key2":"val2"}
  10. // map[key1:val1 key2:val2]
  11. }

MapStrAny

  • 说明: MapStrAnymap[string]interface{} 的形式返回 map 的数据的副本。

  • 格式:

  1. MapStrAny() map[string]interface{}
  • 示例:
  1. func ExampleAnyAnyMap_MapStrAny() {
  2. m := gmap.New()
  3. m.Set(1001, "val1")
  4. m.Set(1002, "val2")
  5. n := m.MapStrAny()
  6. fmt.Println(n)
  7. // Output:
  8. // map[1001:val1 1002:val2]
  9. }

FilterEmpty

  • 说明: FilterEmpty 删除值为空的所有键值对。如: 0, nil, false, "", len(slice/map/chan) == 0 这样的值被认为是空的。

  • 格式:

  1. FilterEmpty()
  • 示例:
  1. func ExampleAnyAnyMap_FilterEmpty() {
  2. m := gmap.NewFrom(g.MapAnyAny{
  3. "k1": "",
  4. "k2": nil,
  5. "k3": 0,
  6. "k4": 1,
  7. })
  8. m.FilterEmpty()
  9. fmt.Println(m.Map())
  10. // Output:
  11. // map[k4:1]
  12. }

FilterNil

  • 说明: FilterNil 删除其值为 nil 的所有键值对。

  • 格式:

  1. FilterNil()
  • 示例:
  1. func ExampleAnyAnyMap_FilterNil() {
  2. m := gmap.NewFrom(g.MapAnyAny{
  3. "k1": "",
  4. "k2": nil,
  5. "k3": 0,
  6. "k4": 1,
  7. })
  8. m.FilterNil()
  9. fmt.Println(m.Map())
  10. // May Output:
  11. // map[k1: k3:0 k4:1]
  12. }

Set

  • 说明: Setmap 设置 key/value

  • 格式:

  1. Set(key interface{}, value interface{})
  • 示例:
  1. func ExampleAnyAnyMap_Set() {
  2. m := gmap.New()
  3. m.Set("key1", "val1")
  4. fmt.Println(m)
  5. // Output:
  6. // {"key1":"val1"}
  7. }

Sets

  • 说明: Setsmap 批量设置 key/ value

  • 格式:

  1. Sets(data map[interface{}]interface{})
  • 示例:
  1. func ExampleAnyAnyMap_Sets() {
  2. m := gmap.New()
  3. addMap := make(map[interface{}]interface{})
  4. addMap["key1"] = "val1"
  5. addMap["key2"] = "val2"
  6. addMap["key3"] = "val3"
  7. m.Sets(addMap)
  8. fmt.Println(m)
  9. // Output:
  10. // {"key1":"val1","key2":"val2","key3":"val3"}
  11. }

Search

  • 说明: Search 使用参数 key 搜索 map。如果找到 key,则返回其对应的键值,并且返回参数 foundtrue,否则为 false

  • 格式:

  1. Search(key interface{}) (value interface{}, found bool)
  • 示例:
  1. func ExampleAnyAnyMap_Search() {
  2. m := gmap.New()
  3. m.Set("key1", "val1")
  4. value, found := m.Search("key1")
  5. if found {
  6. fmt.Println("find key1 value:", value)
  7. }
  8. value, found = m.Search("key2")
  9. if !found {
  10. fmt.Println("key2 not find")
  11. }
  12. // Output:
  13. // find key1 value: val1
  14. // key2 not find
  15. }

Get

  • 说明: Get 返回参数 key 对应的值 value,如 key 不存在,则返回 Nil

  • 格式:

  1. Get(key interface{}) (value interface{})
  • 示例:
  1. func ExampleAnyAnyMap_Get() {
  2. m := gmap.New()
  3. m.Set("key1", "val1")
  4. fmt.Println("key1 value:", m.Get("key1"))
  5. fmt.Println("key2 value:", m.Get("key2"))
  6. // Output:
  7. // key1 value: val1
  8. // key2 value: <nil>
  9. }

Pop

  • 说明: Popmap 中随机取出返回一个键值对,并在内部删除该键值对。

  • 格式:

  1. Pop() (key, value interface{})
  • 示例:
  1. func ExampleAnyAnyMap_Pop() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": "v1",
  5. "k2": "v2",
  6. "k3": "v3",
  7. "k4": "v4",
  8. })
  9. fmt.Println(m.Pop())
  10. // May Output:
  11. // k1 v1
  12. }

Pops

  • 说明: Popsmap 中随机取出并删除 size 个键值对。如果 size == -1,则删除并返回所有键值对。

  • 格式:

  1. Pops(size int) map[interface{}]interface{}
  • 示例:
  1. func ExampleAnyAnyMap_Pops() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": "v1",
  5. "k2": "v2",
  6. "k3": "v3",
  7. "k4": "v4",
  8. })
  9. fmt.Println(m.Pops(-1))
  10. fmt.Println("size:", m.Size())
  11. m.Sets(g.MapAnyAny{
  12. "k1": "v1",
  13. "k2": "v2",
  14. "k3": "v3",
  15. "k4": "v4",
  16. })
  17. fmt.Println(m.Pops(2))
  18. fmt.Println("size:", m.Size())
  19. // May Output:
  20. // map[k1:v1 k2:v2 k3:v3 k4:v4]
  21. // size: 0
  22. // map[k1:v1 k2:v2]
  23. // size: 2
  24. }

GetOrSet

  • 说明: GetOrSetkey 存在,则返回 value,如 key 不存在,使用 keyvaluemap 设置键值,然后返回该值。

  • 格式:

  1. GetOrSet(key interface{}, value interface{}) interface{}
  • 示例:
  1. func ExampleAnyAnyMap_GetOrSet() {
  2. m := gmap.New()
  3. m.Set("key1", "val1")
  4. fmt.Println(m.GetOrSet("key1", "NotExistValue"))
  5. fmt.Println(m.GetOrSet("key2", "val2"))
  6. // Output:
  7. // val1
  8. // val2
  9. }

GetOrSetFunc

  • 说明: GetOrSetFunckey 存在,则返回 value,如 key 不存在,使用 keyfunc f 的返回值 给 map 设置键值,然后返回该值。

  • 格式:

  1. GetOrSetFunc(key interface{}, f func() interface{}) interface{}
  • 示例:
  1. func ExampleAnyAnyMap_GetOrSetFunc() {
  2. m := gmap.New()
  3. m.Set("key1", "val1")
  4. fmt.Println(m.GetOrSetFunc("key1", func() interface{} {
  5. return "NotExistValue"
  6. }))
  7. fmt.Println(m.GetOrSetFunc("key2", func() interface{} {
  8. return "NotExistValue"
  9. }))
  10. // Output:
  11. // val1
  12. // NotExistValue
  13. }

GetOrSetFuncLock

  • 说明: GetOrSetFunckey 存在,则返回 value,如 key 不存在,使用 keyfunc f 的返回值 给 map 设置键值,然后返回该值。

  • 注意: GetOrSetFuncLockGetOrSetFunc 函数的不同之处在于它在写锁中执行函数 f

  • 格式:

  1. GetOrSetFuncLock(key interface{}, f func() interface{}) interface{}
  • 示例:
  1. func ExampleAnyAnyMap_GetOrSetFuncLock() {
  2. m := gmap.New()
  3. m.Set("key1", "val1")
  4. fmt.Println(m.GetOrSetFuncLock("key1", func() interface{} {
  5. return "NotExistValue"
  6. }))
  7. fmt.Println(m.GetOrSetFuncLock("key2", func() interface{} {
  8. return "NotExistValue"
  9. }))
  10. // Output:
  11. // val1
  12. // NotExistValue
  13. }

GetVar

  • 说明: GetVar 根据键名 key 查询并返回对应的键值,键值使用泛型类型 *gvar.Var 返回。

  • 格式:

  1. GetVar(key interface{}) *gvar.Var
  • 示例:
  1. func ExampleAnyAnyMap_GetVar() {
  2. m := gmap.New()
  3. m.Set("key1", "val1")
  4. fmt.Println(m.GetVar("key1"))
  5. fmt.Println(m.GetVar("key2").IsNil())
  6. // Output:
  7. // val1
  8. // true
  9. }

GetVarOrSet

  • 说明: GetVarOrSet 根据键名 key 查询并返回对应的键值。当对应的键值不存在时,使用 value 设置该键值,并返回查询/设置的键值。键值使用泛型类型 *gvar.Var 返回。

  • 格式:

  1. GetVarOrSet(key interface{}, value interface{}) *gvar.Var
  • 示例:
  1. func ExampleAnyAnyMap_GetVarOrSet() {
  2. m := gmap.New()
  3. m.Set("key1", "val1")
  4. fmt.Println(m.GetVarOrSet("key1", "NotExistValue"))
  5. fmt.Println(m.GetVarOrSet("key2", "val2"))
  6. // Output:
  7. // val1
  8. // val2
  9. }

GetVarOrSetFunc

  • 说明: GetVarOrSetFunc 根据键名 key 查询并返回对应的键值。当对应的键值不存在时,使用 func f 的返回值设置该键值,并返回查询/设置的键值。键值使用泛型类型 *gvar.Var 返回。

  • 格式:

  1. GetVarOrSetFunc(key interface{}, f func() interface{}) *gvar.Var
  • 示例:
  1. func ExampleAnyAnyMap_GetVarOrSetFunc() {
  2. m := gmap.New()
  3. m.Set("key1", "val1")
  4. fmt.Println(m.GetVarOrSetFunc("key1", func() interface{} {
  5. return "NotExistValue"
  6. }))
  7. fmt.Println(m.GetVarOrSetFunc("key2", func() interface{} {
  8. return "NotExistValue"
  9. }))
  10. // Output:
  11. // val1
  12. // NotExistValue
  13. }

GetVarOrSetFuncLock

  • 说明: GetVarOrSetFuncLock 根据键名 key 查询并返回对应的键值。当对应的键值不存在时,使用 func f 的返回值设置该键值,并返回查询/设置的键值。键值使用泛型类型 *gvar.Var 返回。

  • 注意: GetVarOrSetFuncLockGetVarOrSetFunc 函数的不同之处在于它在写锁中执行函数 f。即当有多个 goroutine 同时调用该方法时,函数 f 将会在执行之前被阻塞。

  • 格式:

  1. GetVarOrSetFuncLock(key interface{}, f func() interface{}) *gvar.Var
  • 示例:
  1. func ExampleAnyAnyMap_GetVarOrSetFuncLock() {
  2. m := gmap.New()
  3. m.Set("key1", "val1")
  4. fmt.Println(m.GetVarOrSetFuncLock("key1", func() interface{} {
  5. return "NotExistValue"
  6. }))
  7. fmt.Println(m.GetVarOrSetFuncLock("key2", func() interface{} {
  8. return "NotExistValue"
  9. }))
  10. // Output:
  11. // val1
  12. // NotExistValue
  13. }

SetIfNotExist

  • 说明:如果 key 不存在,则 SetIfNotExistmap 设置值键值对 key/value,并且返回 true。如果 key 存在,则返回 false,而 value 将被忽略。

  • 格式:

  1. SetIfNotExist(key interface{}, value interface{}) bool
  • 示例:
  1. func ExampleAnyAnyMap_SetIfNotExist() {
  2. var m gmap.Map
  3. fmt.Println(m.SetIfNotExist("k1", "v1"))
  4. fmt.Println(m.SetIfNotExist("k1", "v1"))
  5. fmt.Println(m.Map())
  6. // Output:
  7. // true
  8. // false
  9. // map[k1:v1]
  10. }

SetIfNotExistFunc

  • 说明:如果 key 不存在,则 SetIfNotExistFuncmap 设置值为函数 f 的返回值,并且返回 true。如果 key 存在,则返回 false,并且 value 将被忽略。

  • 格式:

  1. SetIfNotExistFunc(key interface{}, f func() interface{}) bool
  • 示例:
  1. func ExampleAnyAnyMap_SetIfNotExistFunc() {
  2. var m gmap.Map
  3. fmt.Println(m.SetIfNotExistFunc("k1", func() interface{} {
  4. return "v1"
  5. }))
  6. fmt.Println(m.SetIfNotExistFunc("k1", func() interface{} {
  7. return "v1"
  8. }))
  9. fmt.Println(m.Map())
  10. // Output:
  11. // true
  12. // false
  13. // map[k1:v1]
  14. }

SetIfNotExistFuncLock

  • 说明:如果 key 不存在,则 SetIfNotExistFuncmap 设置值为 func c 的返回值,然后返回 true。如果 key 存在,则返回 false,而 value 将被忽略。

  • 注意: SetIfNotExistFuncLockSetIfNotExistFunc 函数的不同之处在于它在 mutex.Lock 中执行函数 f

  • 格式:

  1. SetIfNotExistFuncLock(key interface{}, f func() interface{}) bool
  • 示例:
  1. func ExampleAnyAnyMap_SetIfNotExistFuncLock() {
  2. var m gmap.Map
  3. fmt.Println(m.SetIfNotExistFuncLock("k1", func() interface{} {
  4. return "v1"
  5. }))
  6. fmt.Println(m.SetIfNotExistFuncLock("k1", func() interface{} {
  7. return "v1"
  8. }))
  9. fmt.Println(m.Map())
  10. // Output:
  11. // true
  12. // false
  13. // map[k1:v1]
  14. }

Remove

  • 说明:按给定的 keymap 中删除 value,并返回此删除的 value

  • 格式:

  1. Remove(key interface{}) (value interface{})
  • 示例:
  1. func ExampleAnyAnyMap_Remove() {
  2. var m gmap.Map
  3. m.Set("k1", "v1")
  4. fmt.Println(m.Remove("k1"))
  5. fmt.Println(m.Remove("k2"))
  6. // Output:
  7. // v1
  8. // <nil>
  9. }

Removes

  • 说明: Removes 按给定的 key 批量删除 mapvalue

  • 格式:

  1. Removes(keys []interface{})
  • 示例:
  1. func ExampleAnyAnyMap_Removes() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": "v1",
  5. "k2": "v2",
  6. "k3": "v3",
  7. "k4": "v4",
  8. })
  9. removeList := make([]interface{}, 2)
  10. removeList = append(removeList, "k1")
  11. removeList = append(removeList, "k2")
  12. m.Removes(removeList)
  13. fmt.Println(m.Map())
  14. // Output:
  15. // map[k3:v3 k4:v4]
  16. }

Keys

  • 说明: Keysmap 的所有 key 作为 slice 返回。

  • 格式:

  1. Keys() []interface{}
  • 示例:
  1. func ExampleAnyAnyMap_Keys() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": "v1",
  5. "k2": "v2",
  6. "k3": "v3",
  7. "k4": "v4",
  8. })
  9. fmt.Println(m.Keys())
  10. // Output:
  11. // [k1 k2 k3 k4]
  12. }

Values

  • 说明: Valuesmap 的所有 value 作为 slice 返回。

  • 格式:

  1. Values() []interface{}
  • 示例:
  1. func ExampleAnyAnyMap_Values() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": "v1",
  5. "k2": "v2",
  6. "k3": "v3",
  7. "k4": "v4",
  8. })
  9. fmt.Println(m.Values())
  10. // May Output:
  11. // [v1 v2 v3 v4]
  12. }

Contains

  • 说明: Contains 检查 key 是否存在。如果 key 存在,则返回 true,否则返回 false

  • 注意:键名类型为 interface{},因此匹配判断需要保证类型和数值一致。

  • 格式:

  1. Contains(key interface{}) bool
  • 示例:
  1. func ExampleAnyAnyMap_Contains() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": "v1",
  5. "k2": "v2",
  6. "k3": "v3",
  7. "k4": "v4",
  8. })
  9. fmt.Println(m.Contains("k1"))
  10. fmt.Println(m.Contains("k5"))
  11. // Output:
  12. // true
  13. // false
  14. }

Size

  • 说明: Size 返回 map 的大小。

  • 格式:

  1. Size() int
  • 示例:
  1. func ExampleAnyAnyMap_Size() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": "v1",
  5. "k2": "v2",
  6. "k3": "v3",
  7. "k4": "v4",
  8. })
  9. fmt.Println(m.Size())
  10. // Output:
  11. // 4
  12. }

IsEmpty

  • 说明: IsEmpty 检查 map 是否为空。如果 map 为空,则返回 true,否则返回 false

  • 格式:

  1. IsEmpty() bool
  • 示例:
  1. func ExampleAnyAnyMap_IsEmpty() {
  2. var m gmap.Map
  3. fmt.Println(m.IsEmpty())
  4. m.Set("k1", "v1")
  5. fmt.Println(m.IsEmpty())
  6. // Output:
  7. // true
  8. // false
  9. }

Clear

  • 说明: Clear 删除 map 的所有数据。

  • 格式:

  1. Clear()
  • 示例:
  1. func ExampleAnyAnyMap_Clear() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": "v1",
  5. "k2": "v2",
  6. "k3": "v3",
  7. "k4": "v4",
  8. })
  9. m.Clear()
  10. fmt.Println(m.Map())
  11. // Output:
  12. // map[]
  13. }

Replace

  • 说明: Replace 用给定的 data 完整替换 mapvalue

  • 格式:

  1. Replace(data map[interface{}]interface{})
  • 示例:
  1. func ExampleAnyAnyMap_Replace() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": "v1",
  5. })
  6. var n gmap.Map
  7. n.Sets(g.MapAnyAny{
  8. "k2": "v2",
  9. })
  10. fmt.Println(m.Map())
  11. m.Replace(n.Map())
  12. fmt.Println(m.Map())
  13. n.Set("k2", "v1")
  14. fmt.Println(m.Map())
  15. // Output:
  16. // map[k1:v1]
  17. // map[k2:v2]
  18. // map[k2:v1]
  19. }

LockFunc

  • 说明: LockFunc 在写锁中执行函数 f

  • 格式:

  1. LockFunc(f func(m map[interface{}]interface{}))
  • 示例:
  1. func ExampleAnyAnyMap_LockFunc() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": 1,
  5. "k2": 2,
  6. "k3": 3,
  7. "k4": 4,
  8. })
  9. m.LockFunc(func(m map[interface{}]interface{}) {
  10. totalValue := 0
  11. for _, v := range m {
  12. totalValue += v.(int)
  13. }
  14. fmt.Println("totalValue:", totalValue)
  15. })
  16. // Output:
  17. // totalValue: 10
  18. }

RLockFunc

  • 说明: RLockFunc 在读锁中执行函数 f

  • 格式:

  1. RLockFunc(f func(m map[interface{}]interface{}))
  • 示例:
  1. func ExampleAnyAnyMap_RLockFunc() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": 1,
  5. "k2": 2,
  6. "k3": 3,
  7. "k4": 4,
  8. })
  9. m.RLockFunc(func(m map[interface{}]interface{}) {
  10. totalValue := 0
  11. for _, v := range m {
  12. totalValue += v.(int)
  13. }
  14. fmt.Println("totalValue:", totalValue)
  15. })
  16. // Output:
  17. // totalValue: 10
  18. }

Flip

  • 说明: Flipmapkeyvalue 进行交换。

  • 格式:

  1. Flip()
  • 示例:
  1. func ExampleAnyAnyMap_Flip() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": "v1",
  5. })
  6. m.Flip()
  7. fmt.Println(m.Map())
  8. // Output:
  9. // map[v1:k1]
  10. }

Merge

  • 说明: Merge 合并两个AnyAnyMap。入参 map 将合并到原 map 中。

  • 格式:

  1. Merge(other *AnyAnyMap)
  • 示例:
  1. func ExampleAnyAnyMap_Merge() {
  2. var m1, m2 gmap.Map
  3. m1.Set("key1", "val1")
  4. m2.Set("key2", "val2")
  5. m1.Merge(&m2)
  6. fmt.Println(m1.Map())
  7. // May Output:
  8. // map[key1:val1 key2:val2]
  9. }

String

  • 说明: String 以字符串形式返回 map

  • 格式:

  1. String() string
  • 示例:
  1. func ExampleAnyAnyMap_String() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": "v1",
  5. })
  6. fmt.Println(m.String())
  7. // Output:
  8. // {"k1":"v1"}
  9. }

MarshalJSON

  • 说明: MarshalJSON 实现 json.Marshal 的接口。

  • 格式:

  1. MarshalJSON() ([]byte, error)
  • 示例:
  1. func ExampleAnyAnyMap_MarshalJSON() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": "v1",
  5. "k2": "v2",
  6. "k3": "v3",
  7. "k4": "v4",
  8. })
  9. bytes, err := m.MarshalJSON()
  10. if err == nil {
  11. fmt.Println(gconv.String(bytes))
  12. }
  13. // Output:
  14. // {"k1":"v1","k2":"v2","k3":"v3","k4":"v4"}
  15. }

UnmarshalJSON

  • 说明: UnmarshalJSON 实现了 json.Unmarshal 的接口。

  • 格式:

  1. UnmarshalJSON(b []byte) error
  • 示例:
  1. func ExampleAnyAnyMap_UnmarshalJSON() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": "v1",
  5. "k2": "v2",
  6. "k3": "v3",
  7. "k4": "v4",
  8. })
  9. var n gmap.Map
  10. err := n.UnmarshalJSON(gconv.Bytes(m.String()))
  11. if err == nil {
  12. fmt.Println(n.Map())
  13. }
  14. // Output:
  15. // map[k1:v1 k2:v2 k3:v3 k4:v4]
  16. }

UnmarshalValue

  • 说明: UnmarshalValue 是一个接口实现,它通过任意类型的变量初始化当前 map

  • 格式:

  1. UnmarshalValue(value interface{}) (err error)
  • 示例:
  1. func ExampleAnyAnyMap_UnmarshalValue() {
  2. var m gmap.Map
  3. m.Sets(g.MapAnyAny{
  4. "k1": "v1",
  5. "k2": "v2",
  6. "k3": "v3",
  7. "k4": "v4",
  8. })
  9. var n gmap.Map
  10. err := n.UnmarshalValue(m.String())
  11. if err == nil {
  12. fmt.Println(n.Map())
  13. }
  14. // Output:
  15. // map[k1:v1 k2:v2 k3:v3 k4:v4]
  16. }