sliceutil

README

sliceutil

sliceutil 提供了针对数组和切片的功能

• At 查找符合条件的元素；
• Index 查找符合条件元素在数组中的位置；
• Reverse 反转数组中的元素；
• Delete 删除符合条件的切片元素；
• QuickDelete 删除符合条件的切片元素，性能稍高于 Delete；
• Count 统计数组或切片中包含指定什的数量；
• Unique 提取数组中的唯一元素；
• Dup 查看数组或切片中是否包含重得的值；
• Contains 判断一个数组或是切片是否包含了另一个的所有元素；

从 0.8.0 开始采用泛型技术，仅支持 go1.18 以上版本

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 int) bool {
    return intSlice[i] == 7
})

// 会重新调整切片的内容，将删除后的数据在放最前端，并返回新切片。
slice := Delete(intSlice, func(i 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 文件中找到。

Documentation

Overview

Package sliceutil 提供对切片的相关功能

Index

• func At[T any](slice []T, eq func(e T) bool) (T, bool)
• func Contains[T any](container, sub []T, eq func(i, j T) bool) bool
• func Count[T any](slice []T, eq func(e T) bool) (count int)
• func Delete[T any](slice []T, eq func(e T) bool) []T
• func Dup[T any](slice []T, eq func(i, j T) bool) (indexes []int)
• func Exists[T any](slice []T, eq func(e T) bool) bool
• func Index[T any](slice []T, eq func(e T) bool) (index int)
• func QuickDelete[T any](slice []T, eq func(e T) bool) []T
• func Reverse[T any](slice []T)
• func Unique[T any](slice []T, eq func(i, j T) bool) []T

Examples

• At
• Contains
• Count
• Delete
• Dup
• Exists
• Index
• Unique

Functions

func At

func At[T any](slice []T, eq func(e T) bool) (T, bool)

At 从 slice 中查找符合 eq 的元素

Example

intSlice := []int{1, 2, 3, 7, 0, 4, 7}
v, found := At(intSlice, func(e int) bool {
	return e == 7
})
fmt.Println(found, v)

Output:

true 7

func Contains

func Contains[T any](container, sub []T, eq func(i, j T) bool) bool

Contains container 是否包含了 sub 中的所有元素

container 与 sub 都必须是数组或是切片类型。 如果只是需要判断某一个值是否在 container 中，可以使用 Count() 函数。 eq 用于判断两个数组或是切的某个元素是否相等，其原型为：

func(i, j int) bool

i 表示 sub 的第 i 个元素，j 表示 container 的第 j 个元素，两者顺序不能乱。

Example

ints1 := []int{1, 2, 3, 4, 5}
ints2 := []int{1, 5, 2}
fmt.Println(Contains(ints1, ints2, func(i, j int) bool {
	return i == j
}))

Output:

true

func Count

func Count[T any](slice []T, eq func(e T) bool) (count int)

Count 检测数组中指定值的数量

eq 对比函数，e 表示数组的元素；

Example

intSlice := []int{1, 2, 3, 7, 0, 4, 7}
fmt.Println(Count(intSlice, func(e int) bool {
	return e == 7
}))

Output:

2

func Delete

func Delete[T any](slice []T, eq func(e T) bool) []T

Delete 删除 slice 中符合 eq 条件的元素

eq 对比函数，用于确定指定的元素是否可以删除，返回 true 表示可以删除；

Example

intSlice := []int{1, 2, 3, 7, 0, 4, 7}
rslt := Delete(intSlice, func(e int) bool {
	return e == 7
})
fmt.Println("Delete:", rslt)

intSlice = []int{1, 2, 3, 7, 0, 4, 7}
rslt = QuickDelete(intSlice, func(e int) bool {
	return e == 7 || e == 2
})
fmt.Println("QuickDelete:", rslt)

Output:

Delete: [1 2 3 0 4]
QuickDelete: [1 4 3 0]

func Dup

func Dup[T any](slice []T, eq func(i, j T) bool) (indexes []int)

Dup 检测数组或是切片中是否包含重复的值

在存在相同元素时，会返回该相同元素的下标列表， 当有多组相同元素时，仅返回第一组相同元素的下标。

Example

intSlice := []int{1, 2, 3, 7, 0, 4, 7}
fmt.Println(Dup(intSlice, func(i, j int) bool {
	return i == j
}))

Output:

[3 6]

func Exists

func Exists[T any](slice []T, eq func(e T) bool) bool

Exists 判断 slice 中是否存在符合 eq 的元素存在

Example

intSlice := []int{1, 2, 3, 7, 0, 4, 7}
fmt.Println(Exists(intSlice, func(e int) bool {
	return e == 7
}))

Output:

true

func Index

func Index[T any](slice []T, eq func(e T) bool) (index int)

Index 从 slice 查找符合 eq 的第一个元素并返回其在数组中的元素

Example

intSlice := []int{1, 2, 3, 7, 0, 4, 7}
fmt.Println(Index(intSlice, func(e int) bool {
	return e == 7
}))

Output:

3

func QuickDelete

func QuickDelete[T any](slice []T, eq func(e T) bool) []T

QuickDelete 删除 slice 中符合 eq 条件的元素

功能与 Delete 相同，但是性能相对 Delete 会好一些，同时也不再保证元素顺序与原数组相同。

func Reverse

func Reverse[T any](slice []T)

Reverse 反转数组中的元素

func Unique

func Unique[T any](slice []T, eq func(i, j T) bool) []T

Unique 提取 slice 中的所有唯一值

NOTE: 此操作会改变 slice 元素顺序。

Example

intSlice := []int{1, 2, 3, 7, 0, 4, 7}
rslt := Unique(intSlice, func(i, j int) bool {
	return i == j
})
fmt.Println(rslt)

Output:

[1 2 3 7 0 4]