以下常用方法列表,文档更新可能滞后于代码新特性,更多的方法及示例请参考代码文档: https://pkg.go.dev/github.com/gogf/gf/v2/container/gset
这里以 StrSet
类型介绍方法使用,其他集合类型的方法与此类似,不再赘述。
NewStrSet
- 说明:
NewStrSet
创建并返回一个空的集合,其中包含没有重复字符串的数据。参数safe
用于指定是否在并发安全中使用,默认情况下是false
。 - 格式:
func NewStrSet(safe ...bool) *StrSet
- 示例:
func ExampleNewStrSet() {
strSet := gset.NewStrSet(true)
strSet.Add([]string{"str1", "str2", "str3"}...)
fmt.Println(strSet.Slice())
// May Output:
// [str3 str1 str2]
}
NewStrSetFrom
- 说明:
NewStrSetFrom
通过给定的数组创建集合集合。参数safe
用于指定是否在并发安全中使用,默认情况下是false
。 - 格式:
func NewStrSetFrom(items []string, safe ...bool) *StrSet
- 示例:
func ExampleNewStrSetFrom() {
strSet := gset.NewStrSetFrom([]string{"str1", "str2", "str3"}, true)
fmt.Println(strSet.Slice())
// May Output:
// [str1 str2 str3]
}
Add
- 说明:
Add
添加一个或多个元素项到集合中。 - 格式:
func (set *StrSet) Add(item ...string)
- 示例:
func ExampleStrSet_Add() {
strSet := gset.NewStrSetFrom([]string{"str1", "str2", "str3"}, true)
strSet.Add("str")
fmt.Println(strSet.Slice())
fmt.Println(strSet.AddIfNotExist("str"))
// Mya Output:
// [str str1 str2 str3]
// false
}
AddIfNotExist
- 说明:
Addifnotexist
检查集合中是否存在指定元素项item
,如果不存在则将item
添加到集合中并返回true
,否则什么也不做并返回false
。 - 格式:
func (set *StrSet) AddIfNotExist(item string) bool
- 示例:
func ExampleStrSet_AddIfNotExist() {
strSet := gset.NewStrSetFrom([]string{"str1", "str2", "str3"}, true)
strSet.Add("str")
fmt.Println(strSet.Slice())
fmt.Println(strSet.AddIfNotExist("str"))
// Mya Output:
// [str str1 str2 str3]
// false
}
AddIfNotExistFunc
- 说明:
AddIfNotExistFunc
检查集合中存在指定元素项item
,如果不存在并且方法f
返回true
时,则将item
设置到集合中并返回true
,否则什么也不做并返回false
。 - 格式:
func (set *StrSet) AddIfNotExistFunc(item string, f func() bool) bool
- 示例:
func ExampleStrSet_AddIfNotExistFunc() {
strSet := gset.NewStrSetFrom([]string{"str1", "str2", "str3"}, true)
strSet.Add("str")
fmt.Println(strSet.Slice())
fmt.Println(strSet.AddIfNotExistFunc("str5", func() bool {
return true
}))
// May Output:
// [str1 str2 str3 str]
// true
}
AddIfNotExistFuncLock
- 说明:
AddifnotExistFuncLock
与AddIfNotExistFunc
类似,不过当多个goroutine
同时调用AddifnotExistFuncLock
方法时,内部使用并发安全锁机制保证同时只能一个goroutine
执行。该方法只有在创建集合时的safe
参数设置true
时有效,否则表现和方法一致AddIfNotExistFunc
。 - 格式:
func (set *StrSet) AddIfNotExistFuncLock(item string, f func() bool) bool
- 示例:
func ExampleStrSet_AddIfNotExistFuncLock() {
strSet := gset.NewStrSetFrom([]string{"str1", "str2", "str3"}, true)
strSet.Add("str")
fmt.Println(strSet.Slice())
fmt.Println(strSet.AddIfNotExistFuncLock("str4", func() bool {
return true
}))
// May Output:
// [str1 str2 str3 str]
// true
}
Clear
- 说明:
Clear
删除集合的所有元素项。 - 格式:
func (set *StrSet) Clear()
- 示例:
func ExampleStrSet_Clear() {
strSet := gset.NewStrSetFrom([]string{"str1", "str2", "str3"}, true)
fmt.Println(strSet.Size())
strSet.Clear()
fmt.Println(strSet.Size())
// Output:
// 3
// 0
}
Intersect
- 说明:
Intrersect
执行集合set
与others
的交集,并返回一个新的集合newSet
,在newSet
中的元素项同时存在于集合set
与others
中。 - 格式:
func (set *StrSet) Intersect(others ...*StrSet) (newSet *StrSet)
- 示例:
func ExampleStrSet_Intersect() {
s1 := gset.NewStrSet(true)
s1.Add([]string{"a", "b", "c"}...)
var s2 gset.StrSet
s2.Add([]string{"a", "b", "c", "d"}...)
fmt.Println(s2.Intersect(s1).Slice())
// May Output:
// [c a b]
}
Diff
- 说明:
Diff
执行集合set
与others
差集操作,并返回一个新的集合newSet
。在newSet
中的元素项存在于set
但不存在于集合others
。注意,参数others
可以指定多个集合参数。 - 格式:
func (set *StrSet) Diff(others ...*StrSet) (newSet *StrSet)