Golang通用数据结构操作工具插件库just的使用

just是一个Golang工具库，包含了许多帮助简化项目中常见操作的实用功能。

主要功能

• 过滤切片和映射
• 对集合应用函数
• 提供Null[any]类型用于API和sql.DB查询中的可选字段

最有用的函数

• SliceIter：允许使用特殊的IterContext迭代切片，提供IsFirst、IsLast等方法
• SliceMap和SliceMapErr：将一个切片映射到另一个切片，适用于适配器
• NewPool：使用泛型的sync.Pool
• ChanAdapt：创建通道的适配版本
• ContextWithTimeout：使用上下文和超时运行函数
• ErrAs：帮助处理错误
• SliceChunk：迭代分块
• SliceChain：将多个切片连接成一个
• StrSplitByChars：按字符分割字符串

示例代码

SliceMap示例

package main

import (
	"fmt"
	"github.com/kazhuravlev/just"
)

func main() {
	// 将字符串切片转换为长度切片
	names := []string{"Alice", "Bob", "Charlie"}
	nameLengths := just.SliceMap(names, func(name string) int {
		return len(name)
	})
	
	fmt.Println(nameLengths) // 输出: [5 3 7]
}

SliceIter示例

package main

import (
	"fmt"
	"github.com/kazhuravlev/just"
)

func main() {
	numbers := []int{10, 20, 30, 40}
	
	just.SliceIter(numbers, func(ctx just.IterContext[int], num int) {
		if ctx.IsFirst() {
			fmt.Println("开始迭代:")
		}
		
		fmt.Printf("索引: %d, 值: %d", ctx.Index(), num)
		
		if !ctx.IsLast() {
			fmt.Print(" | ")
		} else {
			fmt.Println("\n迭代结束")
		}
	})
	
	// 输出:
	// 开始迭代:
	// 索引: 0, 值: 10 | 索引: 1, 值: 20 | 索引: 2, 值: 30 | 索引: 3, 值: 40
	// 迭代结束
}

SliceChunk示例

package main

import (
	"fmt"
	"github.com/kazhuravlev/just"
)

func main() {
	data := []int{1, 2, 3, 4, 5, 6, 7, 8, 9}
	chunks := just.SliceChunk(data, 3)
	
	for _, chunk := range chunks {
		fmt.Println(chunk)
	}
	
	// 输出:
	// [1 2 3]
	// [4 5 6]
	// [7 8 9]
}

NewPool示例

package main

import (
	"fmt"
	"github.com/kazhuravlev/just"
)

func main() {
	// 创建一个字符串池
	stringPool := just.NewPool(func() string {
		return "" // 初始化新字符串
	})
	
	// 从池中获取字符串
	str := stringPool.Get()
	str = "Hello, World!"
	
	// 使用后放回池中
	stringPool.Put(str)
	
	// 再次获取
	str2 := stringPool.Get()
	fmt.Println(str2) // 可能是之前的值或新初始化的空字符串
}

ContextWithTimeout示例

package main

import (
	"context"
	"fmt"
	"time"
	"github.com/kazhuravlev/just"
)

func longRunningTask(ctx context.Context) error {
	select {
	case <-time.After(2 * time.Second):
		fmt.Println("任务完成")
		return nil
	case <-ctx.Done():
		fmt.Println("任务取消")
		return ctx.Err()
	}
}

func main() {
	err := just.ContextWithTimeout(1*time.Second, longRunningTask)
	fmt.Println("错误:", err) // 输出: 错误: context deadline exceeded
}

just库包含了许多其他有用的函数，建议查看官方文档获取完整的功能列表和更多示例。