Treat object function args more consistently

[Pisces] / numeric.js

diff --git a/numeric.js b/numeric.js
index 78ea64c50aa080746ac4a206e41e71b2c5ebb017..44c7cd5649772257f688cf5572236ce2452295e7 100644 (file)
--- a/numeric.js
+++ b/numeric.js
@@ -618,6 +618,29 @@ export const {
   };
 })();
 
+/**
+ * Returns the result of converting the provided number to an integer
+ * or infinity.
+ *
+ * ☡ This function does not allow big·int arguments.
+ */
+export const toIntegerOrInfinity = ($) => {
+  const integer = trunc($);
+  if (isNan(integer) || integer == 0) {
+    // The provided value truncs to nan or (positive or negative) zero.
+    return 0;
+  } else if (integer == POSITIVE_INFINITY) {
+    // The provided value truncs to positive infinity.
+    return POSITIVE_INFINITY;
+  } else if (integer == NEGATIVE_INFINITY) {
+    // The provided value truncs to negative infinity.
+    return NEGATIVE_INFINITY;
+  } else {
+    // The provided value truncs to an integer.
+    return integer;
+  }
+};
+
 /**
  * Returns the result of converting the provided value to a number.
  *