@lijuhong1981/jsmath 1.0.15 → 1.0.16

package/index.js

@@ -44,6 +44,7 @@ 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";
@@ -99,6 +100,7 @@ export {
     convertToLatitudeRange,
     convertToLongitudeRange,
     equalsEpsilon,
+    extractFraction,
     isBetween,
     lerp,
     scalarInRange,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lijuhong1981/jsmath",
-  "version": "1.0.15",
+  "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

@@ -1,3 +1,8 @@
+/**
+ * 自动判断传入的数值类型并转换为数字
+ * @param {Number|String} value
+ * @returns {Number}
+ */
 function parseNumber(value) {
     if (typeof value === 'string') {
         return parseFloat(value);

package/src/toFixed.js

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