mathjs 14.0.0 → 14.1.0

package/lib/cjs/function/relational/larger.js

@@ -13,11 +13,12 @@ var _matAlgo12xSfs = require("../../type/matrix/utils/matAlgo12xSfs.js");
 var _matrixAlgorithmSuite = require("../../type/matrix/utils/matrixAlgorithmSuite.js");
 var _compareUnits = require("./compareUnits.js");
 const name = 'larger';
-const dependencies = ['typed', 'config', 'matrix', 'DenseMatrix', 'concat', 'SparseMatrix'];
+const dependencies = ['typed', 'config', 'bignumber', 'matrix', 'DenseMatrix', 'concat', 'SparseMatrix'];
 const createLarger = exports.createLarger = /* #__PURE__ */(0, _factory.factory)(name, dependencies, _ref => {
   let {
     typed,
     config,
+    bignumber,
     matrix,
     DenseMatrix,
     concat,
@@ -74,16 +75,23 @@ const createLarger = exports.createLarger = /* #__PURE__ */(0, _factory.factory)
    * @param  {number | BigNumber | bigint | Fraction | boolean | Unit | string | Array | Matrix} y Second value to compare
    * @return {boolean | Array | Matrix} Returns true when the x is larger than y, else returns false
    */
+  function bignumLarger(x, y) {
+    return x.gt(y) && !(0, _nearlyEqual.nearlyEqual)(x, y, config.relTol, config.absTol);
+  }
   return typed(name, createLargerNumber({
     typed,
     config
   }), {
     'boolean, boolean': (x, y) => x > y,
-    'BigNumber, BigNumber': function (x, y) {
-      return x.gt(y) && !(0, _nearlyEqual.nearlyEqual)(x, y, config.relTol, config.absTol);
-    },
+    'BigNumber, BigNumber': bignumLarger,
     'bigint, bigint': (x, y) => x > y,
     'Fraction, Fraction': (x, y) => x.compare(y) === 1,
+    'Fraction, BigNumber': function (x, y) {
+      return bignumLarger(bignumber(x), y);
+    },
+    'BigNumber, Fraction': function (x, y) {
+      return bignumLarger(x, bignumber(y));
+    },
     'Complex, Complex': function () {
       throw new TypeError('No ordering relation is defined for complex numbers');
     }

package/lib/cjs/function/relational/smaller.js

@@ -13,11 +13,12 @@ var _matAlgo12xSfs = require("../../type/matrix/utils/matAlgo12xSfs.js");
 var _matrixAlgorithmSuite = require("../../type/matrix/utils/matrixAlgorithmSuite.js");
 var _compareUnits = require("./compareUnits.js");
 const name = 'smaller';
-const dependencies = ['typed', 'config', 'matrix', 'DenseMatrix', 'concat', 'SparseMatrix'];
+const dependencies = ['typed', 'config', 'bignumber', 'matrix', 'DenseMatrix', 'concat', 'SparseMatrix'];
 const createSmaller = exports.createSmaller = /* #__PURE__ */(0, _factory.factory)(name, dependencies, _ref => {
   let {
     typed,
     config,
+    bignumber,
     matrix,
     DenseMatrix,
     concat,
@@ -74,16 +75,23 @@ const createSmaller = exports.createSmaller = /* #__PURE__ */(0, _factory.factor
    * @param  {number | BigNumber | bigint | Fraction | boolean | Unit | string | Array | Matrix} y Second value to compare
    * @return {boolean | Array | Matrix} Returns true when the x is smaller than y, else returns false
    */
+  function bignumSmaller(x, y) {
+    return x.lt(y) && !(0, _nearlyEqual.nearlyEqual)(x, y, config.relTol, config.absTol);
+  }
   return typed(name, createSmallerNumber({
     typed,
     config
   }), {
     'boolean, boolean': (x, y) => x < y,
-    'BigNumber, BigNumber': function (x, y) {
-      return x.lt(y) && !(0, _nearlyEqual.nearlyEqual)(x, y, config.relTol, config.absTol);
-    },
+    'BigNumber, BigNumber': bignumSmaller,
     'bigint, bigint': (x, y) => x < y,
     'Fraction, Fraction': (x, y) => x.compare(y) === -1,
+    'Fraction, BigNumber': function (x, y) {
+      return bignumSmaller(bignumber(x), y);
+    },
+    'BigNumber, Fraction': function (x, y) {
+      return bignumSmaller(x, bignumber(y));
+    },
     'Complex, Complex': function (x, y) {
       throw new TypeError('No ordering relation is defined for complex numbers');
     }

package/lib/cjs/function/statistics/max.js

@@ -89,7 +89,7 @@ const createMax = exports.createMax = /* #__PURE__ */(0, _factory.factory)(name,
     let res;
     (0, _collection.deepForEach)(array, function (value) {
       try {
-        if (isNaN(value) && typeof value === 'number') {
+        if (typeof value === 'number' && isNaN(value)) {
           res = NaN;
         } else if (res === undefined || larger(value, res)) {
           res = value;

package/lib/cjs/function/statistics/min.js

@@ -89,7 +89,7 @@ const createMin = exports.createMin = /* #__PURE__ */(0, _factory.factory)(name,
     let min;
     (0, _collection.deepForEach)(array, function (value) {
       try {
-        if (isNaN(value) && typeof value === 'number') {
+        if (typeof value === 'number' && isNaN(value)) {
           min = NaN;
         } else if (min === undefined || smaller(value, min)) {
           min = value;

package/lib/cjs/function/string/print.js

@@ -31,12 +31,12 @@ const createPrint = exports.createPrint = /* #__PURE__ */(0, _factory.factory)(n
    *     // the following outputs: 'The value of pi is 3.141592654'
    *     math.print('The value of pi is $pi', {pi: math.pi}, 10)
    *
-   *     // the following outputs: 'hello Mary! The date is 2013-03-23'
+   *     // the following outputs: 'Hello Mary! The date is 2013-03-23'
    *     math.print('Hello $user.name! The date is $date', {
    *       user: {
    *         name: 'Mary',
    *       },
-   *       date: new Date(2013, 2, 23).toISOString().substring(0, 10)
+   *       date: '2013-03-23'
    *     })
    *
    *     // the following outputs: 'My favorite fruits are apples and bananas !'

package/lib/cjs/function/utils/isInteger.js

@@ -32,7 +32,7 @@ const createIsInteger = exports.createIsInteger = /* #__PURE__ */(0, _factory.fa
    *    math.isInteger(math.fraction(4))      // returns true
    *    math.isInteger('3')                   // returns true
    *    math.isInteger([3, 0.5, -2])          // returns [true, false, true]
-   *    math.isInteger(math.complex('2-4i'))  // throws an error
+   *    math.isInteger(math.complex('2-4i'))  // throws TypeError
    *
    * See also:
    *

package/lib/cjs/header.js

@@ -6,11 +6,11 @@
  * It features real and complex numbers, units, matrices, a large set of
  * mathematical functions, and a flexible expression parser.
  *
- * @version 14.0.0
- * @date    2024-11-20
+ * @version 14.1.0
+ * @date    2025-01-24
  *
  * @license
- * Copyright (C) 2013-2024 Jos de Jong <wjosdejong@gmail.com>
+ * Copyright (C) 2013-2025 Jos de Jong <wjosdejong@gmail.com>
  *
  * Licensed under the Apache License, Version 2.0 (the "License"); you may not
  * use this file except in compliance with the License. You may obtain a copy

package/lib/cjs/utils/bigint.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.promoteLogarithm = promoteLogarithm;
+/**
+ * Build a bigint logarithm function from a number logarithm,
+ * still returning a number. The idea is that 15 hexadecimal digits
+ * (60 bits) saturates the mantissa of the log, and each additional hex
+ * digit effectively just adds the log of 16 to the resulting value. So
+ * convert the most significant 15 hex digits to a number and take its
+ * log, and then add the log of 16 for each additional hex digit that
+ * was in the bigint.
+ * For negative numbers (complex logarithms), following the bignum
+ * implementation, it just downgrades to number and uses the complex result.
+ * @param {number} log16  the log of 16
+ * @param {(number) -> number} numberLog  the logarithm function for numbers
+ * @param {ConfigurationObject} config  the mathjs configuration
+ * @param {(number) -> Complex} cplx  the associated Complex log
+ * @returns {(bigint) -> number}   the corresponding logarithm for bigints
+ */
+function promoteLogarithm(log16, numberLog, config, cplx) {
+  return function (b) {
+    if (b > 0 || config.predictable) {
+      if (b <= 0) return NaN;
+      const s = b.toString(16);
+      const s15 = s.substring(0, 15);
+      return log16 * (s.length - s15.length) + numberLog(Number('0x' + s15));
+    }
+    return cplx(b.toNumber());
+  };
+}

package/lib/cjs/utils/number.js

@@ -3,14 +3,13 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.cbrt = exports.atanh = exports.asinh = exports.acosh = exports.DBL_EPSILON = void 0;
+exports.cbrt = exports.atanh = exports.asinh = exports.acosh = void 0;
 exports.copysign = copysign;
 exports.cosh = void 0;
 exports.digits = digits;
 exports.expm1 = void 0;
 exports.format = format;
 exports.isInteger = isInteger;
-exports.isIntegerStr = isIntegerStr;
 exports.log2 = exports.log1p = exports.log10 = void 0;
 exports.nearlyEqual = nearlyEqual;
 exports.normalizeFormatOptions = normalizeFormatOptions;
@@ -40,16 +39,6 @@ function isInteger(value) {
   return isFinite(value) ? value === Math.round(value) : false;
 }
 
-/**
- * Check if a string contains an integer
- * @param {string} str
- * @return {boolean} isInteger
- */
-function isIntegerStr(str) {
-  // regex matching strings like "123" and "-123"
-  return /^-?\d+$/.test(str);
-}
-
 /**
  * Ensure the number type is compatible with the provided value.
  * If not, return 'number' instead.
@@ -69,8 +58,12 @@ function isIntegerStr(str) {
  * @returns {'number' | 'BigNumber' | 'bigint' | 'Fraction'}
  */
 function safeNumberType(numberStr, config) {
-  if (config.number === 'bigint' && !isIntegerStr(numberStr)) {
-    return config.numberFallback;
+  if (config.number === 'bigint') {
+    try {
+      BigInt(numberStr);
+    } catch (_unused) {
+      return config.numberFallback;
+    }
   }
   return config.number;
 }
@@ -634,11 +627,6 @@ function digits(value) {
   .length;
 }
 
-/**
- * Minimum number added to one that makes the result different than one
- */
-const DBL_EPSILON = exports.DBL_EPSILON = Number.EPSILON || 2.2204460492503130808472633361816E-16;
-
 /**
  * Compares two floating point numbers.
  * @param {number} a - First value to compare

package/lib/cjs/version.js

@@ -4,6 +4,6 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.version = void 0;
-const version = exports.version = '14.0.0';
+const version = exports.version = '14.1.0';
 // Note: This file is automatically generated when building math.js.
 // Changes made in this file will be overwritten.

package/lib/esm/entry/dependenciesAny/dependenciesLarger.generated.js

@@ -4,6 +4,7 @@
  */
 import { DenseMatrixDependencies } from './dependenciesDenseMatrixClass.generated.js';
 import { SparseMatrixDependencies } from './dependenciesSparseMatrixClass.generated.js';
+import { bignumberDependencies } from './dependenciesBignumber.generated.js';
 import { concatDependencies } from './dependenciesConcat.generated.js';
 import { matrixDependencies } from './dependenciesMatrix.generated.js';
 import { typedDependencies } from './dependenciesTyped.generated.js';
@@ -11,6 +12,7 @@ import { createLarger } from '../../factoriesAny.js';
 export var largerDependencies = {
   DenseMatrixDependencies,
   SparseMatrixDependencies,
+  bignumberDependencies,
   concatDependencies,
   matrixDependencies,
   typedDependencies,

package/lib/esm/entry/dependenciesAny/dependenciesRandomInt.generated.js

@@ -2,9 +2,11 @@
  * THIS FILE IS AUTO-GENERATED
  * DON'T MAKE CHANGES HERE
  */
+import { log2Dependencies } from './dependenciesLog2.generated.js';
 import { typedDependencies } from './dependenciesTyped.generated.js';
 import { createRandomInt } from '../../factoriesAny.js';
 export var randomIntDependencies = {
+  log2Dependencies,
   typedDependencies,
   createRandomInt
 };

package/lib/esm/entry/dependenciesAny/dependenciesSmaller.generated.js

@@ -4,6 +4,7 @@
  */
 import { DenseMatrixDependencies } from './dependenciesDenseMatrixClass.generated.js';
 import { SparseMatrixDependencies } from './dependenciesSparseMatrixClass.generated.js';
+import { bignumberDependencies } from './dependenciesBignumber.generated.js';
 import { concatDependencies } from './dependenciesConcat.generated.js';
 import { matrixDependencies } from './dependenciesMatrix.generated.js';
 import { typedDependencies } from './dependenciesTyped.generated.js';
@@ -11,6 +12,7 @@ import { createSmaller } from '../../factoriesAny.js';
 export var smallerDependencies = {
   DenseMatrixDependencies,
   SparseMatrixDependencies,
+  bignumberDependencies,
   concatDependencies,
   matrixDependencies,
   typedDependencies,

package/lib/esm/entry/dependenciesNumber/dependenciesRandomInt.generated.js

@@ -2,9 +2,11 @@
  * THIS FILE IS AUTO-GENERATED
  * DON'T MAKE CHANGES HERE
  */
+import { log2Dependencies } from './dependenciesLog2.generated.js';
 import { typedDependencies } from './dependenciesTyped.generated.js';
 import { createRandomInt } from '../../factoriesNumber.js';
 export var randomIntDependencies = {
+  log2Dependencies,
   typedDependencies,
   createRandomInt
 };

package/lib/esm/entry/impureFunctionsNumber.generated.js

@@ -7,7 +7,7 @@ import { config } from './configReadonly.js';
 import { createChainClass, createNode, createObjectNode, createRangeNode, createRelationalNode, createReviver, createSymbolNode, createAccessorNode, createAssignmentNode, createBlockNode, createChain, createConditionalNode, createFunctionNode, createIndexNode, createOperatorNode, createConstantNode, createFunctionAssignmentNode, createParenthesisNode, createArrayNode, createSimplifyConstant, createParse, createResolve, createSimplifyCore, createCompile, createEvaluate, createHelpClass, createParserClass, createSimplify, createDerivative, createRationalize, createHelp, createParser, createCumSumTransform, createApplyTransform, createFilterTransform, createForEachTransform, createMapTransform, createMeanTransform, createSubsetTransform, createRangeTransform, createStdTransform, createSumTransform, createMaxTransform, createMinTransform, createVarianceTransform } from '../factoriesNumber.js';
 import { e, _false, index, _Infinity, LN10, LOG10E, matrix, _NaN, _null, phi, Range, replacer, ResultSet, SQRT1_2,
 // eslint-disable-line camelcase
-subset, tau, typed, unaryPlus, version, xor, abs, acos, acot, acsc, add, and, asec, asin, atan, atanh, bigint, bitNot, bitXor, boolean, cbrt, combinations, compare, compareText, cos, cot, csc, cube, divide, equalScalar, erf, exp, filter, forEach, format, gamma, isInteger, isNegative, isPositive, isZero, LOG2E, largerEq, leftShift, log, log1p, map, mean, mod, multiply, not, number, or, pi, pow, random, rightLogShift, SQRT2, sech, sin, size, smallerEq, square, string, subtract, tanh, typeOf, unequal, xgcd, acoth, addScalar, asech, bitAnd, combinationsWithRep, cosh, csch, divideScalar, equalText, expm1, isNumeric, LN2, lcm, log10, multiplyScalar, nthRoot, pickRandom, randomInt, rightArithShift, sec, sinh, sqrt, tan, unaryMinus, acosh, apply, asinh, bitOr, clone, coth, equal, factorial, hasNumericValue, isNaN, larger, log2, mode, norm, partitionSelect, print, round, smaller, subtractScalar, _true, variance, zeta, acsch, atan2, catalan, compareNatural, composition, cumsum, floor, hypot, lgamma, median, multinomial, permutations, quantileSeq, sign, std, stirlingS2, ceil, deepEqual, fix, isPrime, numeric, prod, bellNumbers, gcd, mad, range, sum, corr, max, min } from './pureFunctionsNumber.generated.js';
+subset, tau, typed, unaryPlus, version, xor, abs, acos, acot, acsc, add, and, asec, asin, atan, atanh, bigint, bitNot, bitXor, boolean, cbrt, combinations, compare, compareText, cos, cot, csc, cube, divide, equalScalar, erf, exp, filter, forEach, format, gamma, isInteger, isNegative, isPositive, isZero, LOG2E, largerEq, leftShift, log, log1p, map, mean, mod, multiply, not, number, or, pi, pow, random, rightLogShift, SQRT2, sech, sin, size, smallerEq, square, string, subtract, tanh, typeOf, unequal, xgcd, acoth, addScalar, asech, bitAnd, combinationsWithRep, cosh, csch, divideScalar, equalText, expm1, isNumeric, LN2, lcm, log10, multiplyScalar, nthRoot, pickRandom, rightArithShift, sec, sinh, sqrt, tan, unaryMinus, acosh, apply, asinh, bitOr, clone, coth, equal, factorial, hasNumericValue, isNaN, larger, log2, mode, norm, partitionSelect, print, randomInt, round, smaller, subtractScalar, _true, variance, zeta, acsch, atan2, catalan, compareNatural, composition, cumsum, floor, hypot, lgamma, median, multinomial, permutations, quantileSeq, sign, std, stirlingS2, ceil, deepEqual, fix, isPrime, numeric, prod, bellNumbers, gcd, mad, range, sum, corr, max, min } from './pureFunctionsNumber.generated.js';
 var math = {}; // NOT pure!
 var mathWithTransform = {}; // NOT pure!
 var classes = {}; // NOT pure!
@@ -325,7 +325,6 @@ _extends(math, {
   multiplyScalar,
   nthRoot,
   pickRandom,
-  randomInt,
   rightArithShift,
   sec,
   sinh,
@@ -348,6 +347,7 @@ _extends(math, {
   norm,
   partitionSelect,
   print,
+  randomInt,
   round,
   smaller,
   subtractScalar,

package/lib/esm/entry/pureFunctionsAny.generated.js

@@ -344,6 +344,7 @@ export var isPrime = /* #__PURE__ */createIsPrime({
 });
 export var randomInt = /* #__PURE__ */createRandomInt({
   config,
+  log2,
   typed
 });
 export var sech = /* #__PURE__ */createSech({
@@ -604,6 +605,7 @@ export var round = /* #__PURE__ */createRound({
 export var smaller = /* #__PURE__ */createSmaller({
   DenseMatrix,
   SparseMatrix,
+  bignumber,
   concat,
   config,
   matrix,
@@ -783,6 +785,7 @@ export var Index = /* #__PURE__ */createIndexClass({
 export var larger = /* #__PURE__ */createLarger({
   DenseMatrix,
   SparseMatrix,
+  bignumber,
   concat,
   config,
   matrix,

package/lib/esm/entry/pureFunctionsNumber.generated.js

@@ -5,7 +5,7 @@
 import { config } from './configReadonly.js';
 import { createE, createFalse, createIndex, createInfinity, createLN10, createLOG10E, createMatrix, createNaN, createNull, createPhi, createRangeClass, createReplacer, createResultSet, createSQRT1_2,
 // eslint-disable-line camelcase
-createSubset, createTau, createTyped, createUnaryPlus, createVersion, createXor, createAbs, createAcos, createAcot, createAcsc, createAdd, createAnd, createAsec, createAsin, createAtan, createAtanh, createBigint, createBitNot, createBitXor, createBoolean, createCbrt, createCombinations, createCompare, createCompareText, createCos, createCot, createCsc, createCube, createDivide, createEqualScalar, createErf, createExp, createFilter, createForEach, createFormat, createGamma, createIsInteger, createIsNegative, createIsPositive, createIsZero, createLOG2E, createLargerEq, createLeftShift, createLog, createLog1p, createMap, createMean, createMod, createMultiply, createNot, createNumber, createOr, createPi, createPow, createRandom, createRightLogShift, createSQRT2, createSech, createSin, createSize, createSmallerEq, createSquare, createString, createSubtract, createTanh, createTypeOf, createUnequal, createXgcd, createAcoth, createAddScalar, createAsech, createBitAnd, createCombinationsWithRep, createCosh, createCsch, createDivideScalar, createEqualText, createExpm1, createIsNumeric, createLN2, createLcm, createLog10, createMultiplyScalar, createNthRoot, createPickRandom, createRandomInt, createRightArithShift, createSec, createSinh, createSqrt, createTan, createUnaryMinus, createAcosh, createApply, createAsinh, createBitOr, createClone, createCoth, createEqual, createFactorial, createHasNumericValue, createIsNaN, createLarger, createLog2, createMode, createNorm, createPartitionSelect, createPrint, createRound, createSmaller, createSubtractScalar, createTrue, createVariance, createZeta, createAcsch, createAtan2, createCatalan, createCompareNatural, createComposition, createCumSum, createFloor, createHypot, createLgamma, createMedian, createMultinomial, createPermutations, createQuantileSeq, createSign, createStd, createStirlingS2, createCeil, createDeepEqual, createFix, createIsPrime, createNumeric, createProd, createBellNumbers, createGcd, createMad, createRange, createSum, createCorr, createMax, createMin } from '../factoriesNumber.js';
+createSubset, createTau, createTyped, createUnaryPlus, createVersion, createXor, createAbs, createAcos, createAcot, createAcsc, createAdd, createAnd, createAsec, createAsin, createAtan, createAtanh, createBigint, createBitNot, createBitXor, createBoolean, createCbrt, createCombinations, createCompare, createCompareText, createCos, createCot, createCsc, createCube, createDivide, createEqualScalar, createErf, createExp, createFilter, createForEach, createFormat, createGamma, createIsInteger, createIsNegative, createIsPositive, createIsZero, createLOG2E, createLargerEq, createLeftShift, createLog, createLog1p, createMap, createMean, createMod, createMultiply, createNot, createNumber, createOr, createPi, createPow, createRandom, createRightLogShift, createSQRT2, createSech, createSin, createSize, createSmallerEq, createSquare, createString, createSubtract, createTanh, createTypeOf, createUnequal, createXgcd, createAcoth, createAddScalar, createAsech, createBitAnd, createCombinationsWithRep, createCosh, createCsch, createDivideScalar, createEqualText, createExpm1, createIsNumeric, createLN2, createLcm, createLog10, createMultiplyScalar, createNthRoot, createPickRandom, createRightArithShift, createSec, createSinh, createSqrt, createTan, createUnaryMinus, createAcosh, createApply, createAsinh, createBitOr, createClone, createCoth, createEqual, createFactorial, createHasNumericValue, createIsNaN, createLarger, createLog2, createMode, createNorm, createPartitionSelect, createPrint, createRandomInt, createRound, createSmaller, createSubtractScalar, createTrue, createVariance, createZeta, createAcsch, createAtan2, createCatalan, createCompareNatural, createComposition, createCumSum, createFloor, createHypot, createLgamma, createMedian, createMultinomial, createPermutations, createQuantileSeq, createSign, createStd, createStirlingS2, createCeil, createDeepEqual, createFix, createIsPrime, createNumeric, createProd, createBellNumbers, createGcd, createMad, createRange, createSum, createCorr, createMax, createMin } from '../factoriesNumber.js';
 export var e = /* #__PURE__ */createE({
   config
 });
@@ -296,10 +296,6 @@ export var pickRandom = /* #__PURE__ */createPickRandom({
   config,
   typed
 });
-export var randomInt = /* #__PURE__ */createRandomInt({
-  config,
-  typed
-});
 export var rightArithShift = /* #__PURE__ */createRightArithShift({
   typed
 });
@@ -376,6 +372,11 @@ export var partitionSelect = /* #__PURE__ */createPartitionSelect({
 export var print = /* #__PURE__ */createPrint({
   typed
 });
+export var randomInt = /* #__PURE__ */createRandomInt({
+  config,
+  log2,
+  typed
+});
 export var round = /* #__PURE__ */createRound({
   typed
 });

package/lib/esm/expression/embeddedDocs/function/arithmetic/sign.js

@@ -2,7 +2,7 @@ export var signDocs = {
   name: 'sign',
   category: 'Arithmetic',
   syntax: ['sign(x)'],
-  description: 'Compute the sign of a value. The sign of a value x is 1 when x>1, -1 when x<0, and 0 when x=0.',
+  description: 'Compute the sign of a value. The sign of a value x is 1 when x>0, -1 when x<0, and 0 when x=0.',
   examples: ['sign(3.5)', 'sign(-4.2)', 'sign(0)'],
   seealso: ['abs']
 };