intColl := NewIntCollection([]int{1, 2, 3, 4})
sum := 0
intColl.Each(func(item interface{}, key int) {
v := item.(int)
sum = sum + v
})
if intColl.Err() != nil {
t.Fatal(intColl.Err())
}
if sum != 10 {
t.Fatal("Each 错误")
}
sum = 0
intColl.Each(func(item interface{}, key int) {
v := item.(int)
sum = sum + v
if sum > 4 {
intColl.SetErr(errors.New("stop the cycle"))
return
}
})
if sum != 6 {
t.Fatal("Each 错误")
}
/*
PASS
*/
collection
Collection包目标是用于替换golang原生的Slice,使用场景是在大量不追求极致性能,追求业务开发效能的场景。
go get github.com/jianfengye/collection创建collection库的说明文章见:一个让业务开发效率提高10倍的golang库
Collection包目前支持的元素类型:int32, int, int64, float32, float64, string, struct。
使用下列几个方法进行初始化Collection:
Collection的Error是随着Collection对象走,或者下沉到IMix中,所以可以放心在ICollection和IMix进行链式调用,只需要最后进行一次错误检查即可。
支持的方法有:
Append 挂载一个元素到当前Collection
Avg 返回Collection的数值平均数,只能数值类型coll调用
Contain 判断一个元素是否在Collection中。非数值类型必须设置对象compare方法。
Copy 根据当前的数组,创造出一个同类型的数组
DD 按照友好的格式展示Collection
Diff 获取前一个Collection不在后一个Collection中的元素, 只能数值类型Diff调用
Each 对Collection中的每个函数都进行一次函数调用
Every 判断Collection中的每个元素是否都符合某个条件
ForPage 将Collection函数进行分页
Filter 根据过滤函数获取Collection过滤后的元素
First 获取符合过滤条件的第一个元素
Index 获取元素中的第几个元素,下标从0开始
IsEmpty 判断一个Collection是否为空
IsNotEmpty 判断一个Collection是否为空
Join 将Collection中的元素按照某种方式聚合成字符串
Last 获取该Collection中满足过滤的最后一个元素
Merge 将两个Collection的元素进行合并
Map 对Collection中的每个函数都进行一次函数调用
Mode 获取Collection中的众数
Max 获取Collection中的最大元素
Min 获取Collection中的最小元素
Median 获取Collection的中位数
NewEmpty 根据当前的数组,创造出一个同类型的数组
Nth 获取从offset偏移量开始的每第n个
Pad 填充Collection数组
Pop 从Collection右侧弹出一个元素
Push 往Collection的右侧推入一个元素
Prepend 往Collection左侧加入元素
Pluck 将对象数组中的某个元素提取出来组成一个新的Collection
Reject 将满足过滤条件的元素删除
Reduce 对Collection中的所有元素进行聚合计算
Random 随机获取Collection中的元素
Reverse 将Collection数组进行转置
Slice 获取Collection中的片段
Search 查找Collection中第一个匹配查询元素的下标
Sort 将Collection中的元素进行升序排列输出
SortDesc 将Collection中的元素按照降序排列输出
Sum 返回Collection中的元素的和
Shuffle 将Collection中的元素进行乱序排列
SortBy 根据对象数组中的某个元素进行Collection升序排列
SortByDesc 根据对象数组中的某个元素进行Collection降序排列
ToInts 将Collection变化为int数组
ToInt64s 将Collection变化为int64数组
ToFloat64s 将Collection变化为float64数组
ToFloat32s 将Collection变化为float32数组
ToMixs 将Collection变化为Mix数组
ToInterfaces 将collection变化为interface{}数组
Unique 将Collection中重复的元素进行合并
Append
Append(item interface{}) ICollectionAppend挂载一个元素到当前Collection,如果挂载的元素类型不一致,则会在Collection中产生Error
Avg
Avg() IMix返回Collection的数值平均数,这里会进行类型降级,int,int64,float64的数值平均数都是返回float64类型。
Copy
Copy方法根据当前的数组,创造出一个同类型的数组,有相同的元素
Contain
Contains(obj interface{}) bool判断一个元素是否在Collection中,必须设置compare函数
Diff
Diff(arr ICollection) ICollection获取前一个Collection不在后一个Collection中的元素,必须设置compare函数
DD
DD()DD方法按照友好的格式展示Collection
Each
Each(func(item interface{}, key int))对Collection中的每个函数都进行一次函数调用。传入的参数是回调函数。
如果希望在某次调用的时候中止,在此次调用的时候设置Collection的Error,就可以中止调用。
Every
Every(func(item interface{}, key int) bool) bool判断Collection中的每个元素是否都符合某个条件,只有当每个元素都符合条件,才整体返回true,否则返回false。
ForPage
ForPage(page int, perPage int) ICollection将Collection函数进行分页,按照每页第二个参数的个数,获取第一个参数的页数数据。
Filter
Filter(func(item interface{}, key int) bool) ICollection根据过滤函数获取Collection过滤后的元素。
First
First(...func(item interface{}, key int) bool) IMix获取符合过滤条件的第一个元素,如果没有填写过滤函数,返回第一个元素。
注:只能传递0个或者1个过滤函数,如果传递超过1个过滤函数,只有第一个过滤函数起作用
Index
Index(i int) IMixIndex获取元素中的第几个元素,下标从0开始,如果i超出了长度,则Collection记录错误。
IsEmpty
IsEmpty() bool判断一个Collection是否为空,为空返回true, 否则返回false
IsNotEmpty
IsNotEmpty() bool判断一个Collection是否为空,为空返回false,否则返回true
Join
Join(split string, format ...func(item interface{}) string) string将Collection中的元素按照某种方式聚合成字符串。该函数接受一个或者两个参数,第一个参数是聚合字符串的分隔符号,第二个参数是聚合时候每个元素的格式化函数,如果没有设置第二个参数,则使用
fmt.Sprintf("%v")来该格式化Last
Last(...func(item interface{}, key int) bool) IMix获取该Collection中满足过滤的最后一个元素,如果没有填写过滤条件,默认返回最后一个元素
Merge
Merge(arr ICollection) ICollection将两个Collection的元素进行合并,这个函数会修改原Collection。
Map
Map(func(item interface{}, key int) interface{}) ICollection对Collection中的每个函数都进行一次函数调用,并将返回值组装成ICollection
这个回调函数形如:
func(item interface{}, key int) interface{}如果希望在某此调用的时候中止,就在此次调用的时候设置Collection的Error,就可以中止,且此次回调函数生成的结构不合并到最终生成的ICollection。
Mode
Mode() IMix获取Collection中的众数,如果有大于两个的众数,返回第一次出现的那个。
Max
Max() IMix获取Collection中的最大元素,必须设置compare函数
Min
Min() IMix获取Collection中的最小元素,必须设置compare函数
Median
Median() IMix获取Collection的中位数,如果Collection个数是单数,返回排序后中间的元素,如果Collection的个数是双数,返回排序后中间两个元素的算数平均数。
NewEmpty
NewEmpty(err ...error) ICollectionNewEmpty方法根据当前的数组,创造出一个同类型的数组,但长度为0
Nth
Nth(n int, offset int) ICollectionNth(n int, offset int) 获取从offset偏移量开始的每第n个,偏移量offset的设置为第一个。
Pad
Pad(start int, def interface{}) ICollection填充Collection数组,如果第一个参数大于0,则代表往Collection的右边进行填充,如果第一个参数小于零,则代表往Collection的左边进行填充。
Pop
Pop() IMix从Collection右侧弹出一个元素
Push
Push(item interface{}) ICollection往Collection的右侧推入一个元素
Prepend
Prepend(item interface{}) ICollection往Collection左侧加入元素
Pluck
Pluck(key string) ICollection将对象数组中的某个元素提取出来组成一个新的Collection。这个元素必须是Public元素
注:这个函数只对ObjCollection生效。
Reject
Reject(func(item interface{}, key int) bool) ICollection将满足过滤条件的元素删除
Reduce
Reduce(func(carry IMix, item IMix) IMix) IMix对Collection中的所有元素进行聚合计算。
如果希望在某次调用的时候中止,在此次调用的时候设置Collection的Error,就可以中止调用。
Random
Random() IMix随机获取Collection中的元素,随机数种子使用时间戳
Reverse
Reverse() ICollection将Collection数组进行转置
Search
Search(item interface{}) int查找Collection中第一个匹配查询元素的下标,如果存在,返回下标;如果不存在,返回-1
注意 此函数要求设置compare方法,基础元素数组(int, int64, float32, float64, string)可直接调用!
Slice
Slice(...int) ICollection获取Collection中的片段,可以有两个参数或者一个参数。
如果是两个参数,第一个参数代表开始下标,第二个参数代表结束下标,当第二个参数为-1时候,就代表到Collection结束。
如果是一个参数,则代表从这个开始下标一直获取到Collection结束的片段。
Shuffle
Shuffle() ICollection将Collection中的元素进行乱序排列,随机数种子使用时间戳
Sort
Sort() ICollection将Collection中的元素进行升序排列输出,必须设置compare函数
SortDesc
SortDesc() ICollection将Collection中的元素按照降序排列输出,必须设置compare函数
Sum
Sum() IMix返回Collection中的元素的和
SortBy
SortBy(key string) ICollection根据对象数组中的某个元素进行Collection升序排列。这个元素必须是Public元素
注:这个函数只对ObjCollection生效。这个对象数组的某个元素必须是基础类型。
SortByDesc
SortByDesc(key string) ICollection根据对象数组中的某个元素进行Collection降序排列。这个元素必须是Public元素
注:这个函数只对ObjCollection生效。这个对象数组的某个元素必须是基础类型。
ToInts
ToInts() ([]int, error)将Collection变化为int数组,如果Collection内的元素类型不符合,或者Collection有错误,则返回错误。
ToInt64s
ToInt64s() ([]int64, error)将Collection变化为int64数组,如果Collection内的元素类型不符合,或者Collection有错误,则返回错误。
ToFloat64s
ToFloat64s() ([]float64, error)将Collection变化为float64数组,如果Collection内的元素类型不符合,或者Collection有错误,则返回错误。
ToFloat32s
ToFloat32s() ([]float32, error)将Collection变化为float32数组,如果Collection内的元素类型不符合,或者Collection有错误,则返回错误。
ToMixs
ToMixs() ([]IMix, error)将Collection变化为Mix数组,如果Collection内的元素类型不符合,或者Collection有错误,则返回错误
ToInterfaces
ToInterfaces() ([]interface{}, error)将Collection变化为Interface{}数组,如果Collection内的元素类型不符合,或者Collection有错误,则返回错误
Unique
Unique() ICollection将Collection中重复的元素进行合并,返回唯一的一个数组。
注意 此函数要求设置compare方法,基础元素数组(int, int64, float32, float64, string)可直接调用!
License
collectionis licensed under Apache License.Contributors
This project exists thanks to all the people who contribute. [Contribute].
Backers
Thank you to all our backers! 🙏 [Become a backer]
Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]