# README
sliceutil

sliceutil 提供了针对数组和切片的功能
- At 查找符合条件的元素;
- Index 查找符合条件元素在数组中的位置;
- Indexes 查找所有符合条件元素在数组中的位置;
- Delete 删除符合条件的切片元素;
- QuickDelete 删除符合条件的切片元素,性能稍高于 Delete;
- Count 统计数组或切片中包含指定什的数量;
- Unique 提取数组中的唯一元素;
- Dup 查看数组或切片中是否包含重得的值;
- Contains 判断一个数组或是切片是否包含了另一个的所有元素;
- Filter/SafeFilter 过滤数据;
- FilterSeq: 过滤数据,但是返回的是 iter.Seq 对象;
- AnySlice 将 slices 转换为 []any 类型;
intSlice := []int{1, 2, 3, 7, 0, 4, 7}
intArr := [3]int{1, 7, 0}
// index == [3, 7]
index := Dup(intSlice, func(i, j int) bool {
return intSlice[i] == intSlice[j]
})
// 返回 7 的数量
count := Count(intSlice, func(i, index int) bool {
return intSlice[i] == 7
})
// 会重新调整切片的内容,将删除后的数据在放最前端,并返回新切片。
slice := Delete(intSlice, func(i, index int) bool {
return intSlice[i] == 7
})
// ok == true
ok := Contains(intSlice, intArr, func(i, j int) bool {
return int8(intSlice[i]) == int8Arr[j]
})
安装
go get github.com/issue9/sliceutil
版权
# Functions
AnySlice 将 slices 转换为 []any 类型.
At 从 slice 中查找符合 eq 的元素.
Contains container 是否包含了 sub 中的所有元素
container 与 sub 都必须是数组或是切片类型。 如果只是需要判断某一个值是否在 container 中,可以使用 Count() 函数。 eq 用于判断两个数组或是切的某个元素是否相等,其原型为:
func(i, j int) bool
i 表示 sub 的第 i 个元素,j 表示 container 的第 j 个元素,两者顺序不能乱。.
Count 检测数组中指定值的数量.
Delete 删除 slice 中符合 eq 条件的元素
eq 对比函数,用于确定指定的元素是否可以删除,返回 true 表示可以删除;
NOTE: 大部分时候可以用标准库的 [slices.DeleteFunc] 代替。.
Dup 检测数组或是切片中是否包含重复的值
在存在相同元素时,会返回该相同元素的下标列表, 当有多组相同元素时,仅返回第一组相同元素的下标。.
Exists 判断 slice 中是否存在符合 eq 的元素存在.
Filter 过滤数据
NOTE: 这是基于对原有数据 slices 的修改。.
Filter 过滤数据.
Index 从 slice 查找符合 eq 的第一个元素并返回其在数组中的元素
NOTE: 大部分时候可以用标准库的 [slices.IndexFunc] 代替。.
Indexes 返回所有符合条件的索引.
QuickDelete 删除 slice 中符合 eq 条件的元素
功能与 Delete 相同,但是性能相对 Delete 会好一些,同时也不再保证元素顺序与原数组相同。
NOTE: 大部分时候可以用标准库的 [slices.DeleteFunc] 代替。.
SafeFilter 过滤数据.
Unique 提取 slice 中的所有唯一值
NOTE: 此操作会改变 slice 元素顺序。.