Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jianfengye/collection
go collection package for fasting coding
https://github.com/jianfengye/collection
Last synced: 10 days ago
JSON representation
go collection package for fasting coding
- Host: GitHub
- URL: https://github.com/jianfengye/collection
- Owner: jianfengye
- License: apache-2.0
- Created: 2019-01-27T09:51:46.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-12-05T12:22:14.000Z (11 months ago)
- Last Synced: 2024-04-13T22:03:50.522Z (7 months ago)
- Language: Go
- Homepage:
- Size: 228 KB
- Stars: 637
- Watchers: 19
- Forks: 68
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- go-awesome - collection - Replace native slice (Open source library / Development Aid Package)
README
# collection
Collection包目标是用于替换golang原生的Slice，使用场景是在大量不追求极致性能，追求业务开发效能的场景。
Collection的使用手册线上地址：http://collection.funaio.cn/
你也可以通过类库直接在本地启动本地文档：(需要本机安装npm)
```
npm install
npm run docs:dev
// 访问地址： http://localhost:2333/
```
| 版本 | 说明 |
|--------|----------------------------------------------------------------------------|
| v1.4.2 | 增加KeyByStrField方法，增加交集和并集函数 Union，Intersect |
| v1.4.0 | 增加三种新类型 uint32, uint, uint64, 增加GroupBy 和 Split 方法 |
| v1.3.0 | 增加文档说明 |
| 1.2.0 | 增加对象指针数组，增加测试覆盖率, 增加ToInterfaces方法 |
| 1.1.2 | 增加一些空数组的判断，解决一些issue |
| 1.1.1 | 对collection包进行了json解析和反解析的支持，对mix类型支持了SetField和RemoveFields的类型设置 |
| 1.1.0 | 增加了对int32的支持，增加了延迟加载，增加了Copy函数，增加了compare从ICollection传递到IMix，使用快排加速了Sort方法 |
| 1.0.1 | 第一次发布 |
`go get github.com/jianfengye/[email protected]`
Collection包目前支持的元素类型：int32, int, int64, uint32, uint, uint64, float32, float64, string, object, objectPoint
第一步：使用下列几个方法进行初始化Collection:
```go
NewIntCollection(objs []int) *IntCollection
NewInt64Collection(objs []int64) *Int64Collection
NewInt32Collection(objs []int32) *Int32Collection
NewUIntCollection(objs []uint) *UIntCollection
NewUInt64Collection(objs []uint64) *UInt64Collection
NewUInt32Collection(objs []uint32) *UInt32Collection
NewFloat64Collection(objs []float64) *Float64Collection
NewFloat32Collection(objs []float32) *Float32Collection
NewStrCollection(objs []string) *StrCollection
NewObjCollection(objs interface{}) *ObjCollection
NewObjPointCollection(objs interface{}) *ObjPointCollection
```
第二步：你可以很方便使用ICollection的所有函数：
```
// ICollection 表示数组结构，有几种类型
type ICollection interface {
// Err ICollection错误信息，链式调用的时候需要检查下这个error是否存在，每次调用之后都检查一下
Err() error
// SetErr 设置ICollection的错误信息
SetErr(error) ICollection
/*
下面的方法对所有Collection都生效
*/
// NewEmpty 复制一份当前相同类型的ICollection结构，但是数据是空的
NewEmpty(err ...error) ICollection
// IsEmpty 判断是否是空数组
IsEmpty() bool
// IsNotEmpty 判断是否是空数组
IsNotEmpty() bool
// Append 放入一个元素到数组中，对所有Collection生效, 仅当item和Collection结构不一致的时候返回错误
Append(item interface{}) ICollection
// Remove 删除一个元素, 需要自类实现
Remove(index int) ICollection
// Insert 增加一个元素。
Insert(index int, item interface{}) ICollection
// Search 查找数据中是否包含，-1不包含，>=0 返回数组中元素下标，对所有Collection生效
Search(item interface{}) int
// Unique 过滤数组中重复的元素，仅对基础Collection生效
Unique() ICollection
// Filter 按照某个方法进行过滤, 保留符合的
Filter(func(item interface{}, key int) bool) ICollection
// Reject 按照某个方法进行过滤，去掉符合的
Reject(func(item interface{}, key int) bool) ICollection
// First 获取满足条件的第一个, 如果没有填写过滤条件，就获取所有的第一个
First(...func(item interface{}, key int) bool) IMix
// Last 获取满足条件的最后一个，如果没有填写过滤条件，就获取所有的最后一个
Last(...func(item interface{}, key int) bool) IMix
// Slice 获取数组片段，对所有Collection生效
Slice(...int) ICollection
// Index 获取某个下标，对所有Collection生效
Index(i int) IMix
// SetIndex 设置数组的下标为某个值
SetIndex(i int, val interface{}) ICollection
// Copy 复制当前数组
Copy() ICollection
// Count 获取数组长度，对所有Collection生效
Count() int
// Merge 将两个数组进行合并，参数的数据挂在当前数组中，返回当前数组，对所有Collection生效
Merge(arr ICollection) ICollection
// Each 每个元素都调用一次的方法
Each(func(item interface{}, key int))
// Map 每个元素都调用一次的方法, 并组成一个新的元素
Map(func(item interface{}, key int) interface{}) ICollection
// Reduce 合并一些元素，并组成一个新的元素
Reduce(func(carry IMix, item IMix) IMix) IMix
// Every 判断每个对象是否都满足, 如果collection是空，返回true
Every(func(item interface{}, key int) bool) bool
// ForPage 按照分页进行返回
ForPage(page int, perPage int) ICollection
// Nth 获取从索引offset开始为0，每n位值组成数组
Nth(n int, offset int) ICollection
// Pad 将数组填充到count个数，只能数值型生效
Pad(count int, def interface{}) ICollection
// Pop 从队列右侧弹出结构
Pop() IMix
// Push 推入元素
Push(item interface{}) ICollection
// Prepend 前面插入一个元素
Prepend(item interface{}) ICollection
// Random 随机获取一个元素
Random() IMix
// Reverse 倒置
Reverse() ICollection
// Shuffle 随机乱置
Shuffle() ICollection
// GroupBy 类scala groupby 设计, 根据某个函数分组
GroupBy(func(interface{}, int) interface{}) map[interface{}]ICollection
// Split 按照size个数进行分组
Split(size int) []ICollection
// DD 打印出当前数组结构
DD()
/*
下面的方法对ObjCollection 和 ObjPointCollection 生效
*/
// Pluck 返回数组中对象的某个key组成的数组，仅对ObjectCollection生效, key为对象属性名称，必须为public的属性
Pluck(key string) ICollection
// SortBy 按照某个字段进行排序
SortBy(key string) ICollection
// SortByDesc 按照某个字段进行排序,倒序
SortByDesc(key string) ICollection
// KeyByStrField 根据某个字段为key，返回一个map, 要求key对应的field是string
KeyByStrField(key string) (map[string]interface{}, error)
/*
下面的方法对基础Collection生效，但是ObjCollection一旦设置了Compare函数也生效
*/
// SetCompare 比较a和b，如果a>b, 返回1，如果a
## author
有任何问题可直接github留言，或者联系作者：轩脉刃
