* Returns the result of converting the provided number to an integer
* or infinity.
*
- * ☡ This function does not allow big·int arguments.
+ * ※ This function will never return negative zero.
*/
export const toIntegerOrInfinity = ($) => {
- const integer = trunc($);
+ const integer = trunc(toNumber($));
if (isNan(integer) || integer == 0) {
// The provided value truncs to nan or (positive or negative) zero.
return 0;
}
};
+/**
+ * Returns the result of converting the provided number to an integral
+ * number.
+ *
+ * ※ This function will never return negative zero.
+ */
+export const toIntegralNumber = ($) => {
+ const n = toIntegerOrInfinity($);
+ return !isFiniteNumber(n) || n == 0 ? 0 : n;
+};
+
/**
* Returns the result of converting the provided value to a number.
*
toBigInt,
toFloat32,
toIntegerOrInfinity,
+ toIntegralNumber,
toIntN,
toNumber,
toNumeric,
});
it("[[Call]] returns negative infinity for negative infinity", () => {
- assertStrictEquals(toIntegerOrInfinity(Infinity), Infinity);
+ assertStrictEquals(toIntegerOrInfinity(-Infinity), -Infinity);
+ });
+
+ it("[[Call]] works with big·ints", () => {
+ assertStrictEquals(toIntegerOrInfinity(2n), 2);
+ });
+});
+
+describe("toIntegralNumber", () => {
+ it("[[Call]] converts nan to zero", () => {
+ assertStrictEquals(toIntegralNumber(NaN), 0);
+ });
+
+ it("[[Call]] converts negative zero to positive zero", () => {
+ assertStrictEquals(toIntegralNumber(-0), 0);
+ });
+
+ it("[[Call]] drops the fractional part of negative numbers", () => {
+ assertStrictEquals(toIntegralNumber(-1.79), -1);
+ });
+
+ it("[[Call]] returns zero for infinity", () => {
+ assertStrictEquals(toIntegralNumber(Infinity), 0);
+ });
+
+ it("[[Call]] returns zero for negative infinity", () => {
+ assertStrictEquals(toIntegralNumber(-Infinity), 0);
+ });
+
+ it("[[Call]] works with big·ints", () => {
+ assertStrictEquals(toIntegralNumber(2n), 2);
});
});