Documentation
¶
Overview ¶
Package slicex 提供泛型 Slice 工具函数。
Index ¶
- func Chunk[T any](slice []T, size int) [][]Tdeprecated
- func Contains[T comparable](slice []T, target T) booldeprecated
- func Filter[T any](slice []T, fn func(T) bool) []T
- func First[T any](fn func(T) bool, slice ...T) T
- func Flatten[T any](slices [][]T) []T
- func GroupBy[T any, K comparable](slice []T, fn func(T) K) map[K][]T
- func Index[T comparable](slice []T, target T) intdeprecated
- func Join[T any](slice []T, sep string) string
- func Map[T, R any](slice []T, fn func(T) R) []R
- func Partition[T any](slice []T, fn func(T) bool) (matching, rest []T)
- func Reduce[T, R any](slice []T, init R, fn func(R, T) R) R
- func Reverse[T any](slice []T) []T
- func ToMap[T any, K comparable](slice []T, keyFn func(T) K) map[K]T
- func ToMapStrict[T any, K comparable](slice []T, keyFn func(T) K) (map[K]T, error)
- func Unique[T comparable](slice []T) []T
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Chunk
deprecated
Chunk 将切片分成指定大小的块。
⚠️ **分片与入参共享底层数组**:返回的每个分片都是 slice 的一段视图, 改写分片元素会改写原切片(与 stdlib slices.Chunk 同语义)。同包的 Reverse 明确「返回新切片,不修改原始切片」——本函数的口径与之不同, 调用方需要可改写的结果时自行拷贝。
size <= 0 返回 nil(兼容面保留旧口径;stdlib slices.Chunk 对 n < 1 是 panic,委托前先行拦截)。
Deprecated: 已委托 stdlib slices.Chunk + slices.Collect(#536d),分片 语义与别名语义完全一致。新代码请直接使用 slices.Chunk(Go 1.23 起, 返回 iter.Seq[[]T] 迭代器,range 即得各分片);本符号保留仅为既有调用方 兼容。
func Contains
deprecated
func Contains[T comparable](slice []T, target T) bool
Contains 检查切片中是否包含指定元素。
Deprecated: 已委托 stdlib slices.Contains(#536d),语义完全一致。新代码请 直接使用 slices.Contains;本符号保留仅为既有调用方兼容。
func GroupBy ¶
func GroupBy[T any, K comparable](slice []T, fn func(T) K) map[K][]T
GroupBy 按 key 函数分组。
func Index
deprecated
func Index[T comparable](slice []T, target T) int
Index 返回元素在切片中的索引,不存在返回 -1。
Deprecated: 已委托 stdlib slices.Index(#536d),语义完全一致。新代码请 直接使用 slices.Index;本符号保留仅为既有调用方兼容。
func Partition ¶
Partition 按 fn 返回 true/false 把 slice 分成两组(matching, rest), 保留原顺序。
业务场景: 批量操作时把"成功/失败"分开;订单状态按"已支付/未支付" 分组;任务按"高/低优先级"分组。
用法:
success, failure := slicex.Partition(results, func(r Result) bool {
return r.Error == nil
})
注意: 跟 GroupBy 的区别是 GroupBy 返回 map[K][]T,Partition 返回 两组互斥切片(matching + rest);如果需要 N 个 key 分组用 GroupBy, 二选一分组用 Partition。
func ToMap ¶
func ToMap[T any, K comparable](slice []T, keyFn func(T) K) map[K]T
ToMap 将切片转为 map,key 由 keyFn 提取。 重复 key 取**最后一个**(与 Go map 字面量同语义,#491);需要拒绝重复键 (fail-loud,对齐 strmap.ErrDuplicateKey 的构建期口径)用 ToMapStrict。
func ToMapStrict ¶ added in v0.49.0
func ToMapStrict[T any, K comparable](slice []T, keyFn func(T) K) (map[K]T, error)
ToMapStrict 将切片转为 map,key 由 keyFn 提取;出现重复 key 报错(#491) ——分组/索引场景 keyFn 碰撞是常态,静默覆盖 = 静默丢元素。需要 last-wins 语义用 ToMap。
Types ¶
This section is empty.