Aimless.js API完全参考手册所有函数用法和参数详解【免费下载链接】aimless.jsThe missing JavaScript randomness library.项目地址: https://gitcode.com/gh_mirrors/ai/aimless.jsAimless.js是JavaScript中缺失的随机性库提供了丰富的随机数生成函数满足各种随机数据需求。本文将详细介绍Aimless.js的所有API函数帮助开发者快速掌握这个强大的随机数工具库。核心函数概览Aimless.js的核心功能通过src/aimless.ts文件统一导出主要包含以下几类随机数生成函数基础随机值bool,char,sign数值范围intRange,floatRange概率分布normalDist,exponentialDist,customDist序列生成sequence,intSequence,uniqFuncSequence特殊功能oneOf,weighted,uuid基础随机值生成bool() - 随机布尔值功能生成随机布尔值true或false参数engine: 可选随机数引擎实例默认为defaultEngine示例import { bool } from aimless.js; // 生成随机布尔值 const randomBool bool(); console.log(randomBool); // 输出: true 或 false实现源码src/bool.tschar() - 随机字符功能生成随机字符支持自定义字符集参数chars: 可选字符集字符串默认为大小写字母和数字engine: 可选随机数引擎实例默认为defaultEngine示例import { char } from aimless.js; // 生成随机字母数字字符 const randomChar char(); // 生成随机小写字母 const lowercaseChar char(abcdefghijklmnopqrstuvwxyz);数值范围生成intRange() - 整数范围随机数功能生成指定范围内的随机整数包含边界值参数min: 必需最小值max: 必需最大值engine: 可选随机数引擎实例默认为defaultEngine示例import { intRange } from aimless.js; // 生成1-10之间的随机整数 const randomInt intRange(1, 10); console.log(randomInt); // 输出: 3 (示例)实现源码src/int-range.tsfloatRange() - 浮点数范围随机数功能生成指定范围内的随机浮点数参数min: 必需最小值max: 必需最大值precision: 可选小数位数默认为2engine: 可选随机数引擎实例默认为defaultEngine示例import { floatRange } from aimless.js; // 生成0-1之间的随机浮点数 const randomFloat floatRange(0, 1); // 生成10-20之间保留4位小数的随机浮点数 const preciseFloat floatRange(10, 20, 4);概率分布生成normalDist() - 正态分布随机数功能生成符合正态分布的随机数参数mean: 可选均值默认为0stddev: 可选标准差默认为1engine: 可选随机数引擎实例默认为defaultEngine示例import { normalDist } from aimless.js; // 生成标准正态分布随机数 const normalValue normalDist(); // 生成均值为50标准差为10的正态分布随机数 const customNormal normalDist(50, 10);exponentialDist() - 指数分布随机数功能生成符合指数分布的随机数参数lambda: 可选率参数默认为1engine: 可选随机数引擎实例默认为defaultEngine示例import { exponentialDist } from aimless.js; // 生成率参数为0.5的指数分布随机数 const expValue exponentialDist(0.5);序列与集合操作sequence() - 随机序列生成功能生成包含随机值的序列数组参数length: 必需序列长度generator: 必需生成每个元素的函数engine: 可选随机数引擎实例默认为defaultEngine示例import { sequence, intRange } from aimless.js; // 生成包含5个1-100随机整数的序列 const randomSequence sequence(5, () intRange(1, 100));oneOf() - 从数组中随机选择功能从数组中随机选择一个元素参数array: 必需源数组engine: 可选随机数引擎实例默认为defaultEngine示例import { oneOf } from aimless.js; const fruits [apple, banana, orange, grape]; // 随机选择一个水果 const randomFruit oneOf(fruits);weighted() - 加权随机选择功能根据权重从数组中随机选择元素参数options: 必需包含value和weight属性的对象数组engine: 可选随机数引擎实例默认为defaultEngine示例import { weighted } from aimless.js; const options [ { value: A, weight: 1 }, { value: B, weight: 2 }, { value: C, weight: 3 } ]; // 按权重随机选择C被选中的概率最高 const selected weighted(options);特殊功能uuid() - 生成UUID功能生成符合RFC4122标准的UUID v4参数engine: 可选随机数引擎实例默认为defaultEngine示例import { uuid } from aimless.js; // 生成随机UUID const id uuid(); console.log(id); // 输出: a1b2c3d4-5678-90ef-ghij-klmnopqrstuvseedFunc() - 种子函数生成功能创建可复现的随机数生成函数参数seed: 必需种子值示例import { seedFunc, intRange } from aimless.js; // 创建种子随机数引擎 const seededEngine seedFunc(12345); // 使用种子引擎生成可复现的随机数 const firstRun intRange(1, 100, seededEngine); // 重置引擎后会得到相同的结果 seededEngine.reset(); const secondRun intRange(1, 100, seededEngine); console.log(firstRun secondRun); // 输出: true带引擎的函数变体Aimless.js中的大多数函数都提供了WithEngine后缀的变体如boolWithEngine、intRangeWithEngine这些函数允许你创建绑定到特定引擎的生成器函数示例import { intRangeWithEngine, seedFunc } from aimless.js; // 创建绑定到特定种子引擎的整数生成器 const seededIntRange intRangeWithEngine(seedFunc(9876)); // 后续调用无需再指定引擎 const number1 seededIntRange(1, 10); const number2 seededIntRange(1, 10);安装与使用要开始使用Aimless.js首先需要克隆仓库git clone https://gitcode.com/gh_mirrors/ai/aimless.js cd aimless.js npm install然后在你的项目中导入所需的函数import { intRange, normalDist, oneOf } from aimless.js;总结Aimless.js提供了全面的随机数生成解决方案从简单的布尔值到复杂的概率分布从基础的数值生成到高级的序列操作。通过本文介绍的API你可以轻松实现各种随机数据需求。无论是游戏开发、数据分析还是模拟测试Aimless.js都能成为你可靠的随机数工具库。更多详细信息和高级用法请参考项目的测试文件test/index.js。【免费下载链接】aimless.jsThe missing JavaScript randomness library.项目地址: https://gitcode.com/gh_mirrors/ai/aimless.js创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
