RandomPro

介绍

RandomPro 提供了多种常用的随机方法，如随机整数、随机小数、随机数组元素、打乱数组等。

使用

引入包

在你的 JavaScript 或 TypeScript 文件中，通过import语句引入@dao3fun/random-pro

import RandomPro from "@dao3fun/random-pro";

基本用法

// (如有需要)设置随机种子，默认使用当前时间戳
RandomPro.seed(123);
// 生成一个[0, 1)区间内的随机小数
console.log(RandomPro.random());
// 生成一个[1, 100]区间内的随机整数
console.log(RandomPro.randint(1, 100));
// 生成一个[1, 100)区间内的随机小数
console.log(RandomPro.uniform(1, 100));
// 从数组中随机选取一个元素
const arr = [1, 2, 3, 4, 5];
console.log(RandomPro.choice(arr));
// 从数组中随机选取3个元素
console.log(RandomPro.choice(arr, 3));
// 打乱数组
const shuffledArr = RandomPro.shuffle(arr);
console.log(shuffledArr);

API

class RandomPro {
	static seed(seed: number): void;
	static random(): number;
	static randint(a: number, b: number): number;
	static uniform(a: number, b: number): number;
	static choice<T>(arr: T[], num?: number): T[];
	static shuffle<T>(arr: T[]): T[];
}

seed

seed(seed: number): void

• 设置随机种子，用于控制随机数结果。
• seed: 随机数种子, 整数。
• 如不设置，默认使用当前时间戳。

random

random(): number

• 生成一个[0, 1)区间内的随机小数。

randint

randint(a: number, b: number): number

• 生成一个[a, b]区间内的随机整数。
• a: 整数，区间左端点。
• b: 整数，区间右端点。
• 如 a>b，则交换 a 和 b。

uniform

uniform(a: number, b: number): number

• 生成一个[a, b)区间内的随机小数。
• a: 数字，区间左端点。
• b: 数字，区间右端点。
• 如 a>b，则交换 a 和 b。

choice

choice<T>(arr: T[], num?: number): T[];

• 从数组中随机选取一个元素。
• T(泛型): 数组元素类型。
• arr: 非空数组。
• num = 1: 整数，选取数量，默认为 1。
• 如 num > arr.length，则返回全部元素。

shuffle

shuffle<T>(arr: T[]): T[]

• 打乱数组。
• T(泛型): 数组元素类型。
• arr: 非空数组。