找物源码导读Cocos Creator 3.8 · assets/scripts
0%
已读 0 / 424
目录— 个文件
目录加载中…
…/core/utility/UtilityData.ts
1/** 数据处理工具 */
2export class UtilityData {
3 /**
4 * 数字取精度
5 * @param _n 数字
6 * @param _fixed 精度值
7 */
8 static numberFixed(_n: number, _fixed = 0) {
9 let _fixedN = 1;
10 for (let index = 0; index < _fixed; index++) {
11 _fixedN *= 10;
12 }
13 return Math.round(_n * _fixedN) / _fixedN;
14 }
15 /**
16 * 两个数字在误差内是否相同
17 * @param _n1
18 * @param _n2
19 * @param precision
20 * @returns
21 */
22 static numberEqual(_n1: number, _n2: number, precision = 0.000000002) {
23 return Math.abs(_n1 - _n2) < precision;
24 }
25 /**
26 * 深度拷贝
27 * 注意:仅支持Object/array/基础变量 这类纯数据的拷贝,不支持class
28 * @param {any} sObj 拷贝的对象
29 * @returns
30 */
31 public static deepClone<T extends any>(sObj: T): T {
32 if (typeof sObj !== "object") {
33 return sObj;
34 }
35 let s: any = Array.isArray(sObj) ? [] : {};
36
37 // else if ("constructor" in (sObj as any)) {
38 //     // s = new (sObj as any).constructor.prototype.constructor;
39 //     throw new Error("[deepClone] 不支持类的深拷贝: " + sObj);
40
41 // }
42 for (let i in sObj) {
43 // console.log("i", i, sObj[i]);
44 if ((<any>sObj).hasOwnProperty(i)) {
45 // console.log("i", sObj[i]);
46 s[i] = this.deepClone(sObj[i]);
47 }
48 }
49
50 return s;
51 }
52 /**
53 * 执行深比较来确定两者的值是否相等。
54 * @param {any}p1
55 * @param {any}p2
56 * @returns {boolean} 如果 两个值完全相同,那么返回 true,否则返回 false。
57 */
58 public static isEqual(p1: any, p2: any): boolean {
59 let type1 = typeof p1;
60 let type2 = typeof p2;
61 // 类型是否相同
62 if (type1 !== type2) {
63 return false;
64 }
65 // 方法和符号不加入判断
66 if (type1 == 'function' || type1 == 'symbol') {
67 return true;
68 }
69 // 简单类型直接判断值是否相同
70 if (type1 !== 'object') {
71 return p1 === p2;
72 }
73
74 if (Object.keys(p1).length !== Object.keys(p2).length) {
75 return false;
76 }
77 for (var p in p1) {
78 if (!this.isEqual(p1[p], p2[p])) {
79 return false;
80 }
81 }
82 return true;
83 }
84 // #region 枚举操作
85
86 /**
87 * 获取枚举的所有key
88 * @param _enum
89 * @returns
90 */
91 public static getEnumKeys(_enum: any) {
92 const keys = Object.keys(_enum);
93 if (!keys) {
94 throw new Error("请传入枚举类型");
95 }
96 const isAllNumber = (str: string) => {
97 const reg = /^[0-9]*$/;
98 return reg.test(str)
99 }
100 return keys.filter(v => !isAllNumber(v));
101 }
102 /**
103 * 根据key获取枚举的value
104 * @param _enum
105 * @param key
106 * @returns
107 */
108 public static getEnumValueByKey(_enum: any, key: string) {
109 return _enum[key];
110 }
111 /**
112 * 获取枚举的所有value
113 * @param _enum
114 * @returns
115 */
116 public static getEnumValues(_enum: any) {
117 const keys = this.getEnumKeys(_enum);
118 return keys.map(v => this.getEnumValueByKey(_enum, v));
119 }
120 // #endregion
121
122 /**
123 * 设置对象的属性——主要用于像节点的属性需要改完后再重新赋值
124 * @param obj 对象
125 * @param name 属性名
126 * @param value 修改值
127 */
128 public static setObjectAttribute<T extends Object, Z extends keyof T>(obj: T, name: Z, value: Partial<T[Z]>): T[Z] {
129 if (name in obj) {
130 if (typeof value === 'object') {
131 let obj2 = obj[name];
132 for (let i in value) {
133 obj2[i] = value[i]!;
134 }
135 obj[name] = obj2;
136 } else {
137 obj[name] = value;
138 }
139 }
140 return obj[name];
141 }
142
143}
讲解144 行
数据计算与对象比较工具人工通读

UtilityData.ts

提供小数定精度、浮点近似相等、纯数据深拷贝、深比较、TypeScript 枚举键值读取以及对象属性合并写回。存档整理、配置对比和枚举遍历都依赖这里的实现,其中深拷贝明确不支持类实例。

先看 numberFixed 与 numberEqual 的精度约定,再看 deepClone 与 isEqual 的边界,最后看枚举操作与 setObjectAttribute。

特殊处理与易错点

2注释UtilityData:UtilityData 是「通用工具」目录下的实现/辅助。辅助实现文件,配合同目录的入口类使
8方法按指定小数位把数字放大十的幂次后四舍五入,再缩回原量级并返回。
22方法比较两数差的绝对值是否小于给定精度,用于浮点结果判定。
31方法递归复制对象与数组的自有可枚举属性,基础类型直接返回原值。
42注释else if ("constructor" in (sObj as any)) { // s = new (sObj as any).constructor.prototype.constructor; throw new Error("[deepClone] 不支持类的深拷贝: " + sObj);
58方法先比较类型,再对对象逐键递归比较,键数量不同时直接判为不等。
62注释类型是否相同
66注释方法和符号不加入判断
70注释简单类型直接判断值是否相同
91方法取对象全部键名并过滤纯数字键,返回枚举的命名成员列表。
108方法按键名直接读取枚举对象上的对应值。
116方法先取枚举命名键,再逐个映射为对应值,得到与键顺序一致的值数组。
128方法属性名存在时,对象值逐字段合并进原属性对象后回写,否则直接赋值,最后返回该属性。