GoFrame gmap-方法介紹

以下常用方法列表，文檔更新可能滯后于代碼新特性，更多的方法及示例請參考代碼文檔：https://pkg.go.dev/github.com/gogf/gf/v2/container/gmap

New

• 說明：?New?創(chuàng)建并返回一個空的?AnyAnyMap?。參數(shù)?safe?用于指定是否使用并發(fā)安全的?map?，默認(rèn)情況下為?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?的數(shù)據(jù)創(chuàng)建并返回?AnyAnyMap?。
• 注意：入?yún)?map?將被設(shè)置為底層數(shù)據(jù)映射（無深度拷貝），在外部更改?map?時，可能會同時出現(xiàn)一些安全問題。可選參數(shù)?safe?指定是否在并發(fā)安全中使用此結(jié)構(gòu)，默認(rèn)情況下為?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?使用自定義回調(diào)函數(shù)f以只讀方式迭代?hashmap?。如果?f?返回?true?，則繼續(xù)迭代，返回?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?，其中包含當(dāng)前?map?數(shù)據(jù)的副本。
• 格式：

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 ?返回底層數(shù)據(jù)?map?。
• 注意：如果在并發(fā)安全中，它將返回底層數(shù)據(jù)的副本，否則返回指向底層數(shù)據(jù)的指針。
• 格式：

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?的數(shù)據(jù)的副本。
• 格式：

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?的數(shù)據(jù)的副本。
• 格式：

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? 這樣的值被認(rèn)為是空的。
• 格式：

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?設(shè)置?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?批量設(shè)置?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?使用參數(shù)?key?搜索?map?。如果找到?key?，則返回其對應(yīng)的鍵值，并且返回參數(shù)?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?返回參數(shù)?key?對應(yīng)的值?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?中隨機(jī)取出返回一個鍵值對，并在內(nèi)部刪除該鍵值對。
• 格式：

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
}

Pops

• 說明：?Pops?從?map?中隨機(jī)取出并刪除?size?個鍵值對。如果?size == -1?，則刪除并返回所有鍵值對。
• 格式：

Pops(size int) map[interface{}]interface{}

• 示例：

func ExampleAnyAnyMap_Pops() {
	var m gmap.Map
	m.Sets(g.MapAnyAny{
		"k1": "v1",
		"k2": "v2",
		"k3": "v3",
		"k4": "v4",
	})
	fmt.Println(m.Pops(-1))
	fmt.Println("size:", m.Size())

	m.Sets(g.MapAnyAny{
		"k1": "v1",
		"k2": "v2",
		"k3": "v3",
		"k4": "v4",
	})
	fmt.Println(m.Pops(2))
	fmt.Println("size:", m.Size())

	// May Output:
	// map[k1:v1 k2:v2 k3:v3 k4:v4]
	// size: 0
	// map[k1:v1 k2:v2]
	// size: 2
}

GetOrSet

• 說明：?GetOrSet?如?key?存在，則返回?value?，如?key?不存在，使用?key?和?value?給?map?設(shè)置鍵值，然后返回該值。
• 格式：

GetOrSet(key interface{}, value interface{}) interface{}

• 示例：

func ExampleAnyAnyMap_GetOrSet() {
	m := gmap.New()
	m.Set("key1", "val1")

	fmt.Println(m.GetOrSet("key1", "NotExistValue"))
	fmt.Println(m.GetOrSet("key2", "val2"))

	// Output:
	// val1
	// val2
}

GetOrSetFunc

• 說明：?GetOrSetFunc?如?key?存在，則返回?value?，如?key?不存在，使用?key?和?func f?的返回值 給?map?設(shè)置鍵值，然后返回該值。
• 格式：

GetOrSetFunc(key interface{}, f func() interface{}) interface{}

• 示例：

func ExampleAnyAnyMap_GetOrSetFunc() {
	m := gmap.New()
	m.Set("key1", "val1")

	fmt.Println(m.GetOrSetFunc("key1", func() interface{} {
		return "NotExistValue"
	}))
	fmt.Println(m.GetOrSetFunc("key2", func() interface{} {
		return "NotExistValue"
	}))

	// Output:
	// val1
	// NotExistValue
}

GetOrSetFuncLock

• 說明：?GetOrSetFunc?如?key?存在，則返回?value?，如?key?不存在，使用?key?和?func f?的返回值 給?map?設(shè)置鍵值，然后返回該值。
• 注意：?GetOrSetFuncLock?與?GetOrSetFunc?函數(shù)的不同之處在于它在寫鎖中執(zhí)行函數(shù)?f?。
• 格式：

GetOrSetFuncLock(key interface{}, f func() interface{}) interface{}

• 示例：

func ExampleAnyAnyMap_GetOrSetFuncLock() {
	m := gmap.New()
	m.Set("key1", "val1")

	fmt.Println(m.GetOrSetFuncLock("key1", func() interface{} {
		return "NotExistValue"
	}))
	fmt.Println(m.GetOrSetFuncLock("key2", func() interface{} {
		return "NotExistValue"
	}))

	// Output:
	// val1
	// NotExistValue
}

GetVar

• 說明：?GetVar?根據(jù)鍵名?key?查詢并返回對應(yīng)的鍵值，鍵值使用泛型類型?*gvar.Var?返回。
• 格式：

GetVar(key interface{}) *gvar.Var

• 示例：

func ExampleAnyAnyMap_GetVar() {
	m := gmap.New()
	m.Set("key1", "val1")

	fmt.Println(m.GetVar("key1"))
	fmt.Println(m.GetVar("key2").IsNil())
	
	// Output:
	// val1
	// true
}

GetVarOrSet

• 說明：?GetVarOrSet?根據(jù)鍵名?key?查詢并返回對應(yīng)的鍵值。當(dāng)對應(yīng)的鍵值不存在時，使用?value?設(shè)置該鍵值，并返回查詢/設(shè)置的鍵值。鍵值使用泛型類型?*gvar.Var?返回。
• 格式：

GetVarOrSet(key interface{}, value interface{}) *gvar.Var

• 示例：

func ExampleAnyAnyMap_GetVarOrSet() {
	m := gmap.New()
	m.Set("key1", "val1")

	fmt.Println(m.GetVarOrSet("key1", "NotExistValue"))
	fmt.Println(m.GetVarOrSet("key2", "val2"))

	// Output:
	// val1
	// val2
}

GetVarOrSetFunc

• 說明：?GetVarOrSetFunc?根據(jù)鍵名?key?查詢并返回對應(yīng)的鍵值。當(dāng)對應(yīng)的鍵值不存在時，使用?func f?的返回值設(shè)置該鍵值，并返回查詢/設(shè)置的鍵值。鍵值使用泛型類型?*gvar.Var?返回。
• 格式：

GetVarOrSetFunc(key interface{}, f func() interface{}) *gvar.Var

• 示例：

func ExampleAnyAnyMap_GetVarOrSetFunc() {
	m := gmap.New()
	m.Set("key1", "val1")

	fmt.Println(m.GetVarOrSetFunc("key1", func() interface{} {
		return "NotExistValue"
	}))
	fmt.Println(m.GetVarOrSetFunc("key2", func() interface{} {
		return "NotExistValue"
	}))

	// Output:
	// val1
	// NotExistValue
}

GetVarOrSetFuncLock

• 說明：?GetVarOrSetFuncLock?根據(jù)鍵名?key?查詢并返回對應(yīng)的鍵值。當(dāng)對應(yīng)的鍵值不存在時，使用?func f?的返回值設(shè)置該鍵值，并返回查詢/設(shè)置的鍵值。鍵值使用泛型類型?*gvar.Var?返回。
• 注意：?GetVarOrSetFuncLock?與?GetVarOrSetFunc?函數(shù)的不同之處在于它在寫鎖中執(zhí)行函數(shù)f。即當(dāng)有多個?goroutine?同時調(diào)用該方法時，函數(shù)?f?將會在執(zhí)行之前被阻塞。
• 格式：

GetVarOrSetFuncLock(key interface{}, f func() interface{}) *gvar.Var

• 示例：

func ExampleAnyAnyMap_GetVarOrSetFuncLock() {
	m := gmap.New()
	m.Set("key1", "val1")

	fmt.Println(m.GetVarOrSetFuncLock("key1", func() interface{} {
		return "NotExistValue"
	}))
	fmt.Println(m.GetVarOrSetFuncLock("key2", func() interface{} {
		return "NotExistValue"
	}))

	// Output:
	// val1
	// NotExistValue
}

SetIfNotExist

• 說明：如果?key?不存在，則?SetIfNotExist?為?map?設(shè)置值鍵值對?key/value?，并且返回?true?。如果?key?存在，則返回?false?，而?value?將被忽略。
• 格式：

SetIfNotExist(key interface{}, value interface{}) bool

• 示例：

func ExampleAnyAnyMap_SetIfNotExist() {
	var m gmap.Map
	fmt.Println(m.SetIfNotExist("k1", "v1"))
	fmt.Println(m.SetIfNotExist("k1", "v1"))
	fmt.Println(m.Map())

	// Output:
	// true
	// false
	// map[k1:v1]
}

SetIfNotExistFunc

• 說明：如果?key?不存在，則?SetIfNotExistFunc?為?map?設(shè)置值為函數(shù)f的返回值，并且返回?true?。如果?key?存在，則返回?false?，并且?value?將被忽略。
• 格式：

SetIfNotExistFunc(key interface{}, f func() interface{}) bool

• 示例：

func ExampleAnyAnyMap_SetIfNotExistFunc() {
	var m gmap.Map
	fmt.Println(m.SetIfNotExistFunc("k1", func() interface{} {
		return "v1"
	}))
	fmt.Println(m.SetIfNotExistFunc("k1", func() interface{} {
		return "v1"
	}))
	fmt.Println(m.Map())

	// Output:
	// true
	// false
	// map[k1:v1]
}

SetIfNotExistFuncLock

• 說明：如果?key?不存在，則?SetIfNotExistFunc?為?map?設(shè)置值為?func c?的返回值，然后返回?true?。如果?key?存在，則返回?false?，而?value?將被忽略。
• 注意：?SetIfNotExistFuncLock?與?SetIfNotExistFunc?函數(shù)的不同之處在于它在?mutex.Lock?中執(zhí)行函數(shù)?f?。
• 格式：

SetIfNotExistFuncLock(key interface{}, f func() interface{}) bool

• 示例：

func ExampleAnyAnyMap_SetIfNotExistFuncLock() {
	var m gmap.Map
	fmt.Println(m.SetIfNotExistFuncLock("k1", func() interface{} {
		return "v1"
	}))
	fmt.Println(m.SetIfNotExistFuncLock("k1", func() interface{} {
		return "v1"
	}))
	fmt.Println(m.Map())

	// Output:
	// true
	// false
	// map[k1:v1]
}

Remove

• 說明：按給定的?key?從?map?中刪除?value?，并返回此刪除的?value?。
• 格式：

Remove(key interface{}) (value interface{})

• 示例：

func ExampleAnyAnyMap_Remove() {
	var m gmap.Map
	m.Set("k1", "v1")

	fmt.Println(m.Remove("k1"))
	fmt.Println(m.Remove("k2"))

	// Output:
	// v1
	// <nil>
}

Removes

• 說明：?Removes?按給定的?key?批量刪除?map?的?value?。
• 格式：

Removes(keys []interface{})

• 示例：

func ExampleAnyAnyMap_Removes() {
	var m gmap.Map
	m.Sets(g.MapAnyAny{
		"k1": "v1",
		"k2": "v2",
		"k3": "v3",
		"k4": "v4",
	})

	removeList := make([]interface{}, 2)
	removeList = append(removeList, "k1")
	removeList = append(removeList, "k2")

	m.Removes(removeList)

	fmt.Println(m.Map())

	// Output:
	// map[k3:v3 k4:v4]
}

Keys

• 說明：?Keys?將?map?的所有?key?作為?slice?返回。
• 格式：

Keys() []interface{}

• 示例：

func ExampleAnyAnyMap_Keys() {
	var m gmap.Map
	m.Sets(g.MapAnyAny{
		"k1": "v1",
		"k2": "v2",
		"k3": "v3",
		"k4": "v4",
	})
	fmt.Println(m.Keys())

	// Output:
	// [k1 k2 k3 k4]
}

Values

• 說明：?Values?將?map?的所有?value?作為?slice?返回。
• 格式：

Values() []interface{}

• 示例：

func ExampleAnyAnyMap_Values() {
	var m gmap.Map
	m.Sets(g.MapAnyAny{
		"k1": "v1",
		"k2": "v2",
		"k3": "v3",
		"k4": "v4",
	})
	fmt.Println(m.Values())

	// May Output:
	// [v1 v2 v3 v4]
}

Contains

• 說明：?Contains?檢查?key?是否存在。如果?key?存在，則返回?true?，否則返回?false?。
• 注意：鍵名類型為?interface{}?，因此匹配判斷需要保證類型和數(shù)值一致。
• 格式：

Contains(key interface{}) bool

• 示例：

func ExampleAnyAnyMap_Contains() {
	var m gmap.Map
	m.Sets(g.MapAnyAny{
		"k1": "v1",
		"k2": "v2",
		"k3": "v3",
		"k4": "v4",
	})
	fmt.Println(m.Contains("k1"))
	fmt.Println(m.Contains("k5"))

	// Output:
	// true
	// false
}

Size

• 說明：?Size?返回?map?的大小。
• 格式：

Size() int

• 示例：

func ExampleAnyAnyMap_Size() {
	var m gmap.Map
	m.Sets(g.MapAnyAny{
		"k1": "v1",
		"k2": "v2",
		"k3": "v3",
		"k4": "v4",
	})

	fmt.Println(m.Size())

	// Output:
	// 4
}

IsEmpty

• 說明：?IsEmpty?檢查?map?是否為空。如果?map?為空，則返回?true?，否則返回?false?。
• 格式：

IsEmpty() bool

• 示例：

func ExampleAnyAnyMap_IsEmpty() {
	var m gmap.Map
	fmt.Println(m.IsEmpty())

	m.Set("k1", "v1")
	fmt.Println(m.IsEmpty())

	// Output:
	// true
	// false
}

Clear

• 說明：?Clear?刪除?map?的所有數(shù)據(jù)。
• 格式：

Clear()

• 示例：

func ExampleAnyAnyMap_Clear() {
	var m gmap.Map
	m.Sets(g.MapAnyAny{
		"k1": "v1",
		"k2": "v2",
		"k3": "v3",
		"k4": "v4",
	})

	m.Clear()

	fmt.Println(m.Map())

	// Output:
	// map[]
}

Replace

• 說明：?Replace?用給定的?data?完整替換?map?的?value?。
• 格式：

Replace(data map[interface{}]interface{})

• 示例：

func ExampleAnyAnyMap_Replace() {
	var m gmap.Map
	m.Sets(g.MapAnyAny{
		"k1": "v1",
	})

	var n gmap.Map
	n.Sets(g.MapAnyAny{
		"k2": "v2",
	})

	fmt.Println(m.Map())

	m.Replace(n.Map())
	fmt.Println(m.Map())

	n.Set("k2", "v1")
	fmt.Println(m.Map())

	// Output:
	// map[k1:v1]
	// map[k2:v2]
	// map[k2:v1]
}

LockFunc

• 說明：?LockFunc?在寫鎖中執(zhí)行函數(shù)?f?。
• 格式：

LockFunc(f func(m map[interface{}]interface{}))

• 示例：

func ExampleAnyAnyMap_LockFunc() {
	var m gmap.Map
	m.Sets(g.MapAnyAny{
		"k1": 1,
		"k2": 2,
		"k3": 3,
		"k4": 4,
	})

	m.LockFunc(func(m map[interface{}]interface{}) {
		totalValue := 0
		for _, v := range m {
			totalValue += v.(int)
		}
		fmt.Println("totalValue:", totalValue)
	})

	// Output:
	// totalValue: 10
}

RLockFunc

• 說明：?RLockFunc?在讀鎖中執(zhí)行函數(shù)?f?。
• 格式：

RLockFunc(f func(m map[interface{}]interface{}))

• 示例：

func ExampleAnyAnyMap_RLockFunc() {
	var m gmap.Map
	m.Sets(g.MapAnyAny{
		"k1": 1,
		"k2": 2,
		"k3": 3,
		"k4": 4,
	})

	m.RLockFunc(func(m map[interface{}]interface{}) {
		totalValue := 0
		for _, v := range m {
			totalValue += v.(int)
		}
		fmt.Println("totalValue:", totalValue)
	})

	// Output:
	// totalValue: 10
}

Flip

• 說明：?Flip?將?map?的?key?與?value?進(jìn)行交換。
• 格式：

Flip()

• 示例：

func ExampleAnyAnyMap_Flip() {
	var m gmap.Map
	m.Sets(g.MapAnyAny{
		"k1": "v1",
	})
	m.Flip()
	fmt.Println(m.Map())

	// Output:
	// map[v1:k1]
}

Merge

• 說明：?Merge?合并兩個?AnyAnyMap?。入?yún)?map?將合并到原?map?中。
• 格式：

Merge(other *AnyAnyMap)

• 示例：

func ExampleAnyAnyMap_Merge() {
	var m1, m2 gmap.Map
	m1.Set("key1", "val1")
	m2.Set("key2", "val2")
	m1.Merge(&m2)
	fmt.Println(m1.Map())

	// May Output:
	// map[key1:val1 key2:val2]
}

String

• 說明：?String?以字符串形式返回?map?。
• 格式：

String() string

• 示例：

func ExampleAnyAnyMap_String() {
	var m gmap.Map
	m.Sets(g.MapAnyAny{
		"k1": "v1",
	})

	fmt.Println(m.String())

	// Output:
	// {"k1":"v1"}
}

MarshalJSON

• 說明：?MarshalJSON?實現(xiàn)?json.Marshal?的接口。
• 格式：

MarshalJSON() ([]byte, error)

• 示例：

func ExampleAnyAnyMap_MarshalJSON() {
	var m gmap.Map
	m.Sets(g.MapAnyAny{
		"k1": "v1",
		"k2": "v2",
		"k3": "v3",
		"k4": "v4",
	})

	bytes, err := m.MarshalJSON()
	if err == nil {
		fmt.Println(gconv.String(bytes))
	}

	// Output:
	// {"k1":"v1","k2":"v2","k3":"v3","k4":"v4"}
}

UnmarshalJSON

• 說明：?UnmarshalJSON?實現(xiàn)了?json.Unmarshal?的接口。
• 格式：

UnmarshalJSON(b []byte) error

• 示例：

func ExampleAnyAnyMap_UnmarshalJSON() {
	var m gmap.Map
	m.Sets(g.MapAnyAny{
		"k1": "v1",
		"k2": "v2",
		"k3": "v3",
		"k4": "v4",
	})

	var n gmap.Map

	err := n.UnmarshalJSON(gconv.Bytes(m.String()))
	if err == nil {
		fmt.Println(n.Map())
	}

	// Output:
	// map[k1:v1 k2:v2 k3:v3 k4:v4]
}

UnmarshalValue

• 說明：?UnmarshalValue?是一個接口實現(xiàn)，它通過任意類型的變量初始化當(dāng)前?map?。
• 格式：

UnmarshalValue(value interface{}) (err error)

• 示例：

func ExampleAnyAnyMap_UnmarshalValue() {
	var m gmap.Map
	m.Sets(g.MapAnyAny{
		"k1": "v1",
		"k2": "v2",
		"k3": "v3",
		"k4": "v4",
	})

	var n gmap.Map
	err := n.UnmarshalValue(m.String())
	if err == nil {
		fmt.Println(n.Map())
	}
	// Output:
	// map[k1:v1 k2:v2 k3:v3 k4:v4]
}