基于 Cocos Creator/Ts 的Linq系统，提供了类似 C# LINQ 的链式操作语法，支持高效的数据查询、转换、分组和聚合，帮助开发者简化复杂的数据操作逻辑。无论是游戏中的道具管理、角色数据筛选，还是 UI 列表的动态渲染，本库都能显著提升开发效率。 ## 开发环境 - 引擎版本：Cocos Creator 3.8.6 - 编程语言：TypeScript ## 已适配平台 | H5 | 微信小游戏 | Android原生 | iOS原生 | 抖音小游戏 | OPPO小游戏 | vivo小游戏 | | ---- | ---------| ----------- | -------|-------|-------|-------| | ✔ | ✔ | ✔ | ✔ |✔ |✔ |✔ | 本资源仅支持测试通过平台，其他平台不做默认支持，请自行适配。 --- ```markdown ## **功能亮点** ✅ **链式操作**：支持流畅的链式调用（如 `.Where(...).Select(...).OrderBy(...)`）。 ✅ **高性能**：基于原生数组优化，兼顾灵活性与执行效率。 ✅ **丰富的方法**：包含 **100+ 方法**，覆盖排序、过滤、分组、数学计算等场景。 ✅ **强类型支持**：完整的 TypeScript 类型定义，提供智能提示和编译时检查。 ✅ **零依赖**：无需额外安装第三方库，开箱即用。 --- ## **安装与使用** ### 安装将 `Linq文件夹` 及文件导入您的 Cocos Creator 项目： ```typescript import List from "./List"; // 根据实际路径调整 ``` ### 基本示例 ```typescript // 初始化列表 const numbers = new List([1, 2, 3, 4, 5]); // 链式操作：筛选偶数 -> 平方 -> 排序 const result = numbers .Where(x => x % 2 === 0) .Select(x => x * x) .OrderByDescending(x => x); // 输出：[16, 4] console.log(result.ToArray()); ``` --- ## **核心功能速览** ### 1. **数据操作** | 方法 | 示例场景 | |---------------------|-----------------------------| | `Add`/`AddRange` | 动态添加道具到背包 | | `Remove`/`RemoveAll`| 根据条件移除过期任务 | | `Insert`/`InsertRange` | 在指定位置插入新关卡数据 | ### 2. **查询与过滤** | 方法 | 示例场景 | |---------------------|-----------------------------| | `Where` | 筛选玩家等级≥10的角色 | | `FirstOrDefault` | 获取玩家当前装备的武器 | | `Contains` | 检查商店是否包含某商品 | ### 3. **排序与分组** | 方法 | 示例场景 | |---------------------|-----------------------------| | `OrderBy` | 按金币数量排序玩家排行榜 | | `GroupBy` | 将道具按类型分组显示 | | `Chunk` | 分页加载大型数据列表 | ### 4. **数学计算** | 方法 | 示例场景 | |------------|-----------------------------| | `Sum` | 计算玩家队伍总战斗力 | | `Average` | 统计关卡平均通关时间 | | `Max` | 查找最高分成就 | ### 5. **高级功能** | 方法 | 示例场景 | |---------------------|-----------------------------| | `Shuffle` | 随机打乱卡牌顺序 | | `ToDictionary` | 将角色数据转换为ID-对象的映射 | | `Zip` | 合并技能列表与冷却时间 | --- ## **使用场景案例** ### 场景1：游戏背包管理 ```typescript // 初始化背包道具 const backpack = new List(items); // 筛选可使用的治疗道具，按优先级排序 const healItems = backpack .Where(item => item.type === ItemType.Heal && item.count > 0) .OrderBy(item => item.priority) .ToList(); ``` ### 场景2：玩家排行榜 ```typescript // 计算前10名玩家的平均分数 const top10Average = players .OrderByDescending(p => p.score) .Take(10) .Average(p => p.score); ``` ### 场景3：技能系统 ```typescript // 合并技能与冷却时间，生成技能槽 const skills = new List(playerSkills); const cooldowns = new List([5, 3, 8]); const skillSlots = skills.Zip(cooldowns, (skill, cd) => ({ ...skill, cooldown: cd })); ``` --- 更多使用方法详见ListExample.ts使用示例。 ### Linq 完整方法列表** （包含 **100+ 方法**，支持搜索和分类筛选） --- #### **构造函数与静态方法** | 方法名 | 功能描述 | |-----------------------------------------|--------------------------------------------------------------------------| | `constructor(source?)` | 初始化列表。参数可以是 `Iterable`、容量（`number`）或空。 | | `static Repeat(element, count)` | 创建一个包含 `count` 次重复 `element` 的列表。 | | `static Empty()` | 返回一个空列表。 | --- #### **元素增删改** | 方法名 | 功能描述 | |-----------------------------------------|--------------------------------------------------------------------------| | `Add(item)` | 向列表末尾添加一个元素。 | | `AddRange(collection)` | 添加一个集合的所有元素。 | | `Insert(index, item)` | 在指定索引插入一个元素。 | | `InsertRange(index, collection)` | 在指定索引插入一个集合的所有元素。 | | `Remove(item)` | 移除第一个匹配的元素，返回是否成功。 | | `RemoveAt(index)` | 移除指定索引的元素。 | | `RemoveRange(index, count)` | 移除从 `index` 开始的 `count` 个元素。 | | `RemoveAll(match?)` | 移除所有满足条件的元素，返回移除数量。若未指定条件，则清空列表。 | | `Clear()` | 清空列表所有元素。 | --- #### **元素查询与筛选** | 方法名 | 功能描述 | |-----------------------------------------|--------------------------------------------------------------------------| | `Get(index)` | 获取指定索引的元素（越界抛出异常）。 | | `Find(match)` | 返回第一个满足条件的元素，未找到返回 `undefined`。 | | `FindAll(match)` | 返回所有满足条件的元素的新列表。 | | `FindIndex(...args)` | 返回第一个满足条件的元素的索引（支持起始索引和范围）。 | | `FindInRange(start, end, match)` | 在指定索引范围内查找满足条件的元素索引。 | | `First(predicate?)` | 返回第一个元素或满足条件的第一个元素（空列表抛出异常）。 | | `FirstOrDefault(defaultValue?)` | 返回第一个元素或默认值（空列表返回默认值）。 | | `Last(predicate?)` | 返回最后一个元素或满足条件的最后一个元素（空列表抛出异常）。 | | `LastOrDefault(defaultValue?)` | 返回最后一个元素或默认值（空列表返回默认值）。 | | `Single(predicate?)` | 返回唯一满足条件的元素（否则抛出异常）。 | | `SingleOrDefault(defaultValue?)` | 返回唯一满足条件的元素或默认值（空列表返回默认值）。 | | `IndexOf(item, index?, count?)` | 返回元素的第一个索引（可指定起始索引和范围）。 | | `LastIndexOf(item, index?, count?)` | 返回元素的最后一个索引（可指定起始索引和范围）。 | | `ElementAt(index)` | 获取指定索引的元素（越界抛出异常）。 | | `ElementAtOrDefault(index)` | 获取指定索引的元素（越界返回 `null`）。 | | `Contains(value, predicate?)` | 判断列表是否包含指定元素（可选条件筛选）。 | | `Exists(match)` | 判断是否存在满足条件的元素。 | --- #### **集合操作** | 方法名 | 功能描述 | |-----------------------------------------|--------------------------------------------------------------------------| | `Concat(list)` | 合并当前列表与参数列表，返回新列表。 | | `Union(list, equalityComparer?)` | 返回两个列表的并集（去重，支持自定义比较器）。 | | `Intersect(list)` | 返回两个列表的交集。 | | `Except(list, equalityComparer?)` | 返回当前列表有但参数列表没有的元素。 | | `Zip(list, result)` | 按索引合并两个列表，通过 `result` 函数生成新元素。 | | `Chunk(size)` | 将列表按指定大小分块，返回块列表。 | | `GroupJoin(source, key1, key2, result)` | 分组连接两个列表，返回分组结果。 | | `Join(source, key1, key2, result)`| 根据键连接两个列表，返回合并结果。 | --- #### **转换与序列化** | 方法名 | 功能描述 | |-----------------------------------------|--------------------------------------------------------------------------| | `ToArray()` | 转换为普通数组。 | | `ToList()` | 返回当前列表的副本。 | | `ToDictionary(...)` | 转换为键值对字典（支持键选择器、值选择器和自定义比较器）。 | | `ToHashSet(equalityComparer?)` | 转换为哈希集合（去重，支持自定义比较器）。 | | `ToLookup(...)` | 转换为分组查找表（支持键选择器、值选择器和自定义比较器）。 | | `Cast()` | 转换元素类型，返回新列表。 | | `OfType(type)` | 过滤指定类型的元素，返回新列表。 | | `AsEnumerable()` | 返回当前列表的可枚举形式。 | --- #### **排序与分组** | 方法名 | 功能描述 | |-----------------------------------------|--------------------------------------------------------------------------| | `Sort(...args)` | 对列表排序（支持比较函数、`IComparer` 或指定范围）。 | | `OrderBy(keySelector, comparer?)` | 按键升序排序，返回新列表。 | | `OrderByDescending(keySelector, comparer?)` | 按键降序排序，返回新列表。 | | `ThenBy(keySelector)` | 在已排序列表基础上，按键升序二次排序。 | | `ThenByDescending(keySelector)` | 在已排序列表基础上，按键降序二次排序。 | | `GroupBy(keySelector, resultSelector?)` | 按键分组，返回 `GroupedList`。 | --- #### **数学计算** | 方法名 | 功能描述 | |-----------------------------------------|--------------------------------------------------------------------------| | `Sum(predicate?)` | 计算元素总和（可选条件筛选）。 | | `Average(predicate?)` | 计算元素平均值（可选条件筛选）。 | | `Min(selector?)` | 返回最小值（可选键选择器）。 | | `Max(selector?)` | 返回最大值（可选键选择器）。 | --- #### **容量与索引** | 方法名 | 功能描述 | |-----------------------------------------|--------------------------------------------------------------------------| | `Capacity` | 获取或设置列表容量（底层数组长度）。 | | `TrimExcess()` | 移除所有 `undefined` 元素以优化容量。 | --- #### **遍历与操作** | 方法名 | 功能描述 | |-----------------------------------------|--------------------------------------------------------------------------| | `ForEach(action)` | 对每个元素执行指定操作。 | | `Reverse(index?, count?)` | 反转元素顺序（可指定范围和数量）。 | | `Shuffle()` | 随机打乱元素顺序（使用 Fisher-Yates 算法）。 | | `Select(selector)` | 将元素按规则转换，返回新列表。 | | `SelectMany(selector, resultSelector?)` | 展开嵌套集合为扁平列表（可选结果选择器）。 | | `Where(predicate)` | 返回满足条件的所有元素的新列表。 | | `WhereNotNull()` | 返回所有非空元素的新列表。 | | `Skip(amount)` | 跳过前 `N` 个元素，返回剩余元素的新列表。 | | `SkipLast(amount)` | 跳过最后 `N` 个元素，返回剩余元素的新列表。 | | `SkipWhile(predicate)` | 跳过满足条件的元素，直到条件不满足为止。 | | `Take(amount)` | 返回前 `N` 个元素的新列表。 | | `TakeLast(amount)` | 返回最后 `N` 个元素的新列表。 | | `TakeWhile(predicate)` | 返回满足条件的元素，直到条件不满足为止。 | --- #### **辅助功能** | 方法名 | 功能描述 | |-----------------------------------------|--------------------------------------------------------------------------| | `Count(predicate?)` | 返回元素总数或满足条件的元素数量。 | | `Any(predicate?)` | 判断列表是否非空或存在满足条件的元素。 | | `All(predicate)` | 判断所有元素是否满足条件。 | | `TrueForAll(predicate)` | 同 `All()`。 | | `Aggregate(accumulator, initialValue)` | 对元素进行累加操作（类似 `reduce`）。 | | `DefaultIfEmpty(defaultValue?)` | 如果列表为空，返回包含默认值的列表。 | | `SequenceEqual(list, equalityComparer?)` | 判断两个列表是否完全相等（支持自定义比较器）。 | --- #### **版本控制与内部方法** | 方法名 | 功能描述 | |-----------------------------------------|--------------------------------------------------------------------------| | `[Symbol.iterator]()` | 实现可迭代接口，支持 `for...of` 循环。 | | `checkIndex(index, allowEqual?)` | （私有）检查索引是否越界。 | | `checkRange(index, count)` | （私有）检查索引和范围是否有效。 | --- **说明**： - **参数说明**： - `predicate`：条件函数，接受元素、索引和数组，返回布尔值。 - `selector`：转换函数，接受元素、索引和数组，返回新值。 - `equalityComparer`：自定义相等性比较函数。 - `comparer`：自定义排序比较函数或 `IComparer` 实例。 - **链式调用**：支持如 `Where(...).Select(...).OrderBy(...)` 的链式操作。 - **异常处理**：越界或无效参数会抛出 `Error`。 - **性能优化**：`Capacity` 可手动调整以减少扩容开销。 --- ![截屏20250519 20.50.00.png](https://download.cocos.com/CocosStore/resource/393f93b7faf740749308f820bef12491/393f93b7faf740749308f820bef12491.png) ![截屏20250519 20.50.15.png](https://download.cocos.com/CocosStore/resource/db6668a4292d431eb262cdceee6a5c64/db6668a4292d431eb262cdceee6a5c64.png) --- **复杂使用示例截图**： ![截屏20250519 20.57.21.png](https://download.cocos.com/CocosStore/resource/894edaf65e46498ea7ec336e064a3002/894edaf65e46498ea7ec336e064a3002.png) --- **此系统提供了类似 C# LINQ 的链式操作语法，支持高效的数据查询、转换、分组和聚合，帮助开发者简化复杂的数据操作逻辑。无论是游戏中的道具管理、角色数据筛选，还是 UI 列表的动态渲染，本库都能显著提升开发效率。您也可以基于此架构进行扩展。** ``` ## 联系作者 - 作者邮箱6656921@qq.com - QQ6656921 ## 版权声明代码为作者所写，商业授权范围仅限于在您自行开发的游戏作品中使用，未经授权，不得进行任何形式的转售、租赁、传播、复制、修改、传播本代码的全部或部分内容； ## 更新声明 - 1.0 - 1.0.0版本发布 ## 购买须知本产品为付费虚拟商品，一经购买成功概不退款，请支付前谨慎确认购买内容。 ```