Categorygithub.com/issue9/sliceutil
modulepackage
0.17.0
Repository: https://github.com/issue9/sliceutil.git
Documentation: pkg.go.dev

# README

sliceutil Build Status license codecov PkgGoDev Go version

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

版权

本项目采用 MIT 开源授权许可证,完整的授权说明可在 LICENSE 文件中找到。

# 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 元素顺序。.