rand

README

关于本项目

本项目完全由 AI 维护。代码源自 github.com/ssgo/u 的重构。

@go/rand

@go/rand 是一个专注于极简调用与极致性能的 Go 随机数库。它通过泛型消除了传统库中繁琐的类型分支，并针对高并发场景进行了底层优化。

🎯 设计哲学

• 极简 API：不再需要区分类型名。一个 Int(min, max) 搞定所有。
• 需求导向：所有函数默认支持范围随机，无需手动计算偏移。
• 零摩擦防御：遵循“No-Panic”准则，自动处理反向区间等异常输入。
• 极致性能：通过 Fast 系列函数彻底解决多核环境下的全局锁竞争瓶颈。

🛠 API Reference

基础随机函数 (基于标准库全局生成器)

• func Int[T IntegerType](min, max T) T：获取 [min, max] 闭区间随机整数。
• func Float[T FloatType](min, max T) T：获取 [min, max) 左闭右开区间随机浮点数。

高性能随机函数 (基于 PCG 无锁池)

在高并发 Server 场景下，推荐使用以下函数以获得极致吞吐量。

• func FastInt[T IntegerType](min, max T) T
• func FastFloat[T FloatType](min, max T) T

字节与切片

• func Byte() byte
• func Bytes(n int) []byte
• func Perm(n int) []int
• func Shuffle(n int, swap func(i, j int))

📦 安装

go get apigo.cc/go/rand

💡 快速开始

import "apigo.cc/go/rand"

// 基础随机
num := rand.Int(1, 100)        // 返回 [1, 100] 的 int

// 高并发场景 (推荐)
userID := rand.FastInt(1000, 9999)

// 字节处理
key := rand.Bytes(16)

Documentation

Index

• func Byte() byte
• func Bytes(n int) []byte
• func FastFloat[T FloatType](min, max T) T
• func FastInt[T IntegerType](min, max T) T
• func Float[T FloatType](min, max T) T
• func Int[T IntegerType](min, max T) T
• func Perm(n int) []int
• func Shuffle(n int, swap func(i, j int))
• type FloatType
• type IntegerType

Functions

func Byte

func Byte() byte

Byte 获取一个随机字节

func Bytes

func Bytes(n int) []byte

Bytes 获取长度为 n 的随机字节切片

func FastFloat

func FastFloat[T FloatType](min, max T) T

FastFloat 获取 [min, max) 区间随机浮点数 (高性能并发模式)

func FastInt

func FastInt[T IntegerType](min, max T) T

FastInt 获取 [min, max] 闭区间随机整数 (高性能并发模式)

func Float

func Float[T FloatType](min, max T) T

Float 获取 [min, max) 区间随机浮点数

func Int

func Int[T IntegerType](min, max T) T

Int 获取 [min, max] 闭区间随机整数

func Perm

func Perm(n int) []int

Perm 获取 [0, n) 的随机排列

func Shuffle

func Shuffle(n int, swap func(i, j int))

Shuffle 随机洗牌

Types

type FloatType

type FloatType interface {
	~float32 | ~float64
}

FloatType 约束支持所有浮点类型

type IntegerType

type IntegerType interface {
	~int | ~int8 | ~int16 | ~int32 | ~int64 |
		~uint | ~uint8 | ~uint16 | ~uint32 | ~uint64 | ~uintptr
}

IntegerType 约束支持所有整数类型