以下常用方法列表,文档更新可能滞后于代码新特性,更多的方法及示例请参考代码文档: https://pkg.go.dev/github.com/gogf/gf/v2/container/gmap
New
-
说明:
New
创建并返回一个空的AnyAnyMap
。参数safe
用于指定是否使用并发安全的map
,默认情况下为false
。 -
格式:
New(safe ...bool) *Map
- 示例:
func ExampleNew() {
m := gmap.New()
// Add data.
m.Set("key1", "val1")
// Print size.
fmt.Println(m.Size())
addMap := make(map[interface{}]interface{})
addMap["key2"] = "val2"
addMap["key3"] = "val3"
addMap[1] = 1
fmt.Println(m.Values())
// Batch add data.
m.Sets(addMap)
// Gets the value of the corresponding key.
fmt.Println(m.Get("key3"))
// Get the value by key, or set it with given key-value if not exist.
fmt.Println(m.GetOrSet("key4", "val4"))
// Set key-value if the key does not exist, then return true; or else return false.
fmt.Println(m.SetIfNotExist("key3", "val3"))
// Remove key
m.Remove("key2")
fmt.Println(m.Keys())
// Batch remove keys.
m.Removes([]interface{}{"key1", 1})
fmt.Println(m.Keys())
// Contains checks whether a key exists.
fmt.Println(m.Contains("key3"))
// Flip exchanges key-value of the map, it will change key-value to value-key.
m.Flip()
fmt.Println(m.Map())
// Clear deletes all data of the map.
m.Clear()
fmt.Println(m.Size())
// May Output:
// 1
// [val1]
// val3
// val4
// false
// [key4 key1 key3 1]
// [key4 key3]
// true
// map[val3:key3 val4:key4]
// 0
}
NewFrom
-
说明:
NewFrom
使用给定map
的数据创建并返回AnyAnyMap
。 -
注意:入参
map
将被设置为底层数据映射(无深度拷贝),在外部更改map
时,可能会同时出现一些安全问题。可选参数safe
指定是否在并发安全中使用此结构,默认情况下为false
。 -
格式:
NewFrom(data map[interface{}]interface{}, safe ...bool) *Map
- 示例:
func ExampleNewFrom() {
m := gmap.New()
m.Set("key1", "val1")
fmt.Println(m)
n := gmap.NewFrom(m.MapCopy(), true)
fmt.Println(n)
// Output:
// {"key1":"val1"}
// {"key1":"val1"}
}
Iterator
-
说明:
Iterator
使用自定义回调函数f
以只读方式迭代hashmap
。如果f
返回true
,则继续迭代,返回false
则停止。 -
格式:
Iterator(f func(k interface{}, v interface{}) bool)
- 示例:
func ExampleAnyAnyMap_Iterator() {
m := gmap.New()
for i := 0; i < 10; i++ {
m.Set(i, i*2)
}
var totalKey, totalValue int
m.Iterator(func(k interface{}, v interface{}) bool {
totalKey += k.(int)
totalValue += v.(int)
return totalKey < 10
})
fmt.Println("totalKey:", totalKey)
fmt.Println("totalValue:", totalValue)
// May Output:
// totalKey: 11
// totalValue: 22
}
Clone
-
说明:
Clone
返回一个新的AnyAnyMap
,其中包含当前map
数 据的副本。 -
格式:
Clone(safe ...bool) *AnyAnyMap
- 示例:
func ExampleAnyAnyMap_Clone() {
m := gmap.New()
m.Set("key1", "val1")
fmt.Println(m)
n := m.Clone()
fmt.Println(n)
// Output:
// {"key1":"val1"}
// {"key1":"val1"}
}
Map
-
说明:
Map
返回底层数据map
。 -
注意:如果在并发安全中,它将返回底层数据的副本,否则返回指向底层数据的指针。
-
格式:
Map() map[interface{}]interface{}
- 示例:
func ExampleAnyAnyMap_Map() {
// non concurrent-safety, a pointer to the underlying data
m1 := gmap.New()
m1.Set("key1", "val1")
fmt.Println("m1:", m1)
n1 := m1.Map()
fmt.Println("before n1:", n1)
m1.Set("key1", "val2")
fmt.Println("after n1:", n1)
// concurrent-safety, copy of underlying data
m2 := gmap.New(true)
m2.Set("key1", "val1")
fmt.Println("m1:", m2)
n2 := m2.Map()
fmt.Println("before n2:", n2)
m2.Set("key1", "val2")
fmt.Println("after n2:", n2)
// Output:
// m1: {"key1":"val1"}
// before n1: map[key1:val1]
// after n1: map[key1:val2]
// m1: {"key1":"val1"}
// before n2: map[key1:val1]
// after n2: map[key1:val1]
}
MapCopy
-
说明:
MapCopy
返回map
的数据的副本。 -
格式:
MapCopy() map[interface{}]interface{}
- 示例:
func ExampleAnyAnyMap_MapCopy() {
m := gmap.New()
m.Set("key1", "val1")
m.Set("key2", "val2")
fmt.Println(m)
n := m.MapCopy()
fmt.Println(n)
// Output:
// {"key1":"val1","key2":"val2"}
// map[key1:val1 key2:val2]
}
MapStrAny
-
说明:
MapStrAny
以map[string]interface{}
的形式返回map
的数据的副本。 -
格式:
MapStrAny() map[string]interface{}
- 示例:
func ExampleAnyAnyMap_MapStrAny() {
m := gmap.New()
m.Set(1001, "val1")
m.Set(1002, "val2")
n := m.MapStrAny()
fmt.Println(n)
// Output:
// map[1001:val1 1002:val2]
}
FilterEmpty
-
说明:
FilterEmpty
删除值为空的所有键值对。如:0
,nil
,false
,""
,len(slice/map/chan) == 0
这样的值被认为是空的。 -
格式:
FilterEmpty()
- 示例:
func ExampleAnyAnyMap_FilterEmpty() {
m := gmap.NewFrom(g.MapAnyAny{
"k1": "",
"k2": nil,
"k3": 0,
"k4": 1,
})
m.FilterEmpty()
fmt.Println(m.Map())
// Output:
// map[k4:1]
}
FilterNil
-
说明:
FilterNil
删除其值为nil
的所有键值对。 -
格式:
FilterNil()
- 示例:
func ExampleAnyAnyMap_FilterNil() {
m := gmap.NewFrom(g.MapAnyAny{
"k1": "",
"k2": nil,
"k3": 0,
"k4": 1,
})
m.FilterNil()
fmt.Println(m.Map())
// May Output:
// map[k1: k3:0 k4:1]
}
Set
-
说明:
Set
为map
设置key/value
。 -
格式:
Set(key interface{}, value interface{})
- 示例:
func ExampleAnyAnyMap_Set() {
m := gmap.New()
m.Set("key1", "val1")
fmt.Println(m)
// Output:
// {"key1":"val1"}
}
Sets
-
说明:
Sets
为map
批量设置key/
value
。 -
格式:
Sets(data map[interface{}]interface{})
- 示例:
func ExampleAnyAnyMap_Sets() {
m := gmap.New()
addMap := make(map[interface{}]interface{})
addMap["key1"] = "val1"
addMap["key2"] = "val2"
addMap["key3"] = "val3"
m.Sets(addMap)
fmt.Println(m)
// Output:
// {"key1":"val1","key2":"val2","key3":"val3"}
}
Search
-
说明:
Search
使用参数key
搜索map
。如果找到key
,则返回其对应的键值,并且返回参数found
为true
,否则为false
。 -
格式:
Search(key interface{}) (value interface{}, found bool)
- 示例:
func ExampleAnyAnyMap_Search() {
m := gmap.New()
m.Set("key1", "val1")
value, found := m.Search("key1")
if found {
fmt.Println("find key1 value:", value)
}
value, found = m.Search("key2")
if !found {
fmt.Println("key2 not find")
}
// Output:
// find key1 value: val1
// key2 not find
}
Get
-
说明:
Get
返回参数key
对应的值value
,如key
不存在,则返回Nil
。 -
格式:
Get(key interface{}) (value interface{})
- 示例:
func ExampleAnyAnyMap_Get() {
m := gmap.New()
m.Set("key1", "val1")
fmt.Println("key1 value:", m.Get("key1"))
fmt.Println("key2 value:", m.Get("key2"))
// Output:
// key1 value: val1
// key2 value: <nil>
}
Pop
-
说明:
Pop
从map
中随机取出返回一个键值对,并在内部删除该键值对。 -
格式:
Pop() (key, value interface{})
- 示例:
func ExampleAnyAnyMap_Pop() {
var m gmap.Map
m.Sets(g.MapAnyAny{
"k1": "v1",
"k2": "v2",
"k3": "v3",
"k4": "v4",
})
fmt.Println(m.Pop())
// May Output:
// k1 v1
}