@lijuhong1981/jsmath 1.0.14 → 1.0.16

package/index.js

@@ -44,12 +44,15 @@ import convertToRadiansCircular from "./src/convertToRadiansCircular.js";
 import convertToLatitudeRange from "./src/convertToLatitudeRange.js";
 import convertToLongitudeRange from "./src/convertToLongitudeRange.js";
 import equalsEpsilon from "./src/equalsEpsilon.js";
+import extractFraction from "./src/extractFraction.js";
 import isBetween from "./src/isBetween.js";
 import lerp from "./src/lerp.js";
 import scalarInRange from "./src/scalarInRange.js";
 import normalize from "./src/normalize.js";
+import parseNumber from "./src/parseNumber.js";
 import randomNumber from "./src/randomNumber.js";
 import randomInteger from "./src/randomInteger.js";
+import toFixed from "./src/toFixed.js";
 import Range from "./src/Range.js";
 
 export {
@@ -97,11 +100,14 @@ export {
     convertToLatitudeRange,
     convertToLongitudeRange,
     equalsEpsilon,
+    extractFraction,
     isBetween,
     lerp,
     scalarInRange,
     normalize,
+    parseNumber,
     randomNumber,
     randomInteger,
+    toFixed,
     Range,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lijuhong1981/jsmath",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "",
   "main": "index.js",
   "module": "index.js",

package/src/equalsEpsilon.js

@@ -1,5 +1,12 @@
 import Check from "@lijuhong1981/jscheck";
 
+/**
+ * 比较两个数值是否近似相等
+ * @param {Number} left 
+ * @param {Number} right
+ * @param {Number} epsilon=0 近似精度，Math.abs(left - right)小于或等于该值时返回true
+ * @returns {Boolean}
+ */
 function equalsEpsilon(left, right, epsilon = 0) {
     Check.typeOf.number('left', left);
     Check.typeOf.number('right', right)

package/src/extractFraction.js

@@ -0,0 +1,19 @@
+import Check from "@lijuhong1981/jscheck";
+
+/**
+ * 从一个数值中提取小数部分
+ * @param {Number} value 传入的数值
+ * @returns {Number} 提取的小数
+ */
+function extractFraction(value) {
+    Check.typeOf.number('value', value);
+
+    value = value.toString();
+    const arr = value.split('.');
+    if (arr.length === 2)
+        return parseFloat('0.' + arr[1]);
+    else
+        return 0.0;
+};
+
+export default extractFraction;

package/src/parseNumber.js

@@ -0,0 +1,16 @@
+/**
+ * 自动判断传入的数值类型并转换为数字
+ * @param {Number|String} value
+ * @returns {Number}
+ */
+function parseNumber(value) {
+    if (typeof value === 'string') {
+        return parseFloat(value);
+    } else if (typeof value === 'number') {
+        return value;
+    } else {
+        throw new Error('unable parse the ' + value + ' to number.');
+    }
+}
+
+export default parseNumber;

package/src/toFixed.js

@@ -0,0 +1,15 @@
+import Check from "@lijuhong1981/jscheck";
+
+/**
+ * 四舍五入一个数值至指定的小数位数
+ * @param {Number} value 传入的数值 
+ * @param {Number} decimalNumber=2 小数位数
+ * @returns {Number}
+ */
+function toFixed(value, decimalNumber = 2) {
+    Check.typeOf.number('value', value);
+
+    return parseFloat(value.toFixed(decimalNumber));
+}
+
+export default toFixed;