slicex

package
v0.53.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 17, 2026 License: MIT Imports: 4 Imported by: 1

Documentation

Overview

Package slicex 提供泛型 Slice 工具函数。

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Chunk deprecated

func Chunk[T any](slice []T, size int) [][]T

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 Filter

func Filter[T any](slice []T, fn func(T) bool) []T

Filter 过滤切片,保留满足条件的元素。

func First

func First[T any](fn func(T) bool, slice ...T) T

First 返回 slice 中第一个满足 fn 的元素。 若无元素满足,返回零值。

func Flatten

func Flatten[T any](slices [][]T) []T

Flatten 将二维切片展平为一维。

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 Join

func Join[T any](slice []T, sep string) string

Join 将切片元素用分隔符连接为字符串。

func Map

func Map[T, R any](slice []T, fn func(T) R) []R

Map 对切片中每个元素应用转换函数。

func Partition

func Partition[T any](slice []T, fn func(T) bool) (matching, rest []T)

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 Reduce

func Reduce[T, R any](slice []T, init R, fn func(R, T) R) R

Reduce 将切片归约为单个值。

func Reverse

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

Reverse 反转切片(返回新切片,不修改原始切片)。

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。

func Unique

func Unique[T comparable](slice []T) []T

Unique 去重,保持原始顺序。

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL