mathjs 13.2.3 → 14.0.0

package/lib/cjs/type/matrix/utils/matAlgo07xSSf.js

@@ -7,31 +7,30 @@ exports.createMatAlgo07xSSf = void 0;
 var _factory = require("../../../utils/factory.js");
 var _DimensionError = require("../../../error/DimensionError.js");
 const name = 'matAlgo07xSSf';
-const dependencies = ['typed', 'DenseMatrix'];
+const dependencies = ['typed', 'SparseMatrix'];
 const createMatAlgo07xSSf = exports.createMatAlgo07xSSf = /* #__PURE__ */(0, _factory.factory)(name, dependencies, _ref => {
   let {
     typed,
-    DenseMatrix
+    SparseMatrix
   } = _ref;
   /**
-   * Iterates over SparseMatrix A and SparseMatrix B items (zero and nonzero) and invokes the callback function f(Aij, Bij).
-   * Callback function invoked MxN times.
-   *
-   * C(i,j) = f(Aij, Bij)
-   *
-   * @param {Matrix}   a                 The SparseMatrix instance (A)
-   * @param {Matrix}   b                 The SparseMatrix instance (B)
-   * @param {Function} callback          The f(Aij,Bij) operation to invoke
-   *
-   * @return {Matrix}                    DenseMatrix (C)
-   *
-   * see https://github.com/josdejong/mathjs/pull/346#issuecomment-97620294
-   */
+  * Iterates over SparseMatrix A and SparseMatrix B items (zero and nonzero) and invokes the callback function f(Aij, Bij).
+  * Callback function invoked MxN times.
+  *
+  * C(i,j) = f(Aij, Bij)
+  *
+  * @param {Matrix}   a                 The SparseMatrix instance (A)
+  * @param {Matrix}   b                 The SparseMatrix instance (B)
+  * @param {Function} callback          The f(Aij,Bij) operation to invoke
+  *
+  * @return {Matrix}                    SparseMatrix (C)
+  *
+  * see https://github.com/josdejong/mathjs/pull/346#issuecomment-97620294
+  */
   return function matAlgo07xSSf(a, b, callback) {
     // sparse matrix arrays
     const asize = a._size;
     const adt = a._datatype || a._data === undefined ? a._datatype : a.getDataType();
-    // sparse matrix arrays
     const bsize = b._size;
     const bdt = b._datatype || b._data === undefined ? b._datatype : b.getDataType();
 
@@ -39,8 +38,6 @@ const createMatAlgo07xSSf = exports.createMatAlgo07xSSf = /* #__PURE__ */(0, _fa
     if (asize.length !== bsize.length) {
       throw new _DimensionError.DimensionError(asize.length, bsize.length);
     }
-
-    // check rows & columns
     if (asize[0] !== bsize[0] || asize[1] !== bsize[1]) {
       throw new RangeError('Dimension mismatch. Matrix A (' + asize + ') must match Matrix B (' + bsize + ')');
     }
@@ -51,59 +48,58 @@ const createMatAlgo07xSSf = exports.createMatAlgo07xSSf = /* #__PURE__ */(0, _fa
 
     // datatype
     let dt;
-    // zero value
     let zero = 0;
-    // callback signature to use
     let cf = callback;
 
     // process data types
     if (typeof adt === 'string' && adt === bdt && adt !== 'mixed') {
-      // datatype
       dt = adt;
-      // convert 0 to the same datatype
       zero = typed.convert(0, dt);
-      // callback
       cf = typed.find(callback, [dt, dt]);
     }
 
-    // vars
-    let i, j;
-
-    // result arrays
-    const cdata = [];
-    // initialize c
-    for (i = 0; i < rows; i++) {
-      cdata[i] = [];
-    }
+    // result arrays for sparse format
+    const cvalues = [];
+    const cindex = [];
+    const cptr = new Array(columns + 1).fill(0); // Start with column pointer array
 
     // workspaces
     const xa = [];
     const xb = [];
-    // marks indicating we have a value in x for a given column
     const wa = [];
     const wb = [];
 
     // loop columns
-    for (j = 0; j < columns; j++) {
-      // columns mark
+    for (let j = 0; j < columns; j++) {
       const mark = j + 1;
-      // scatter the values of A(:,j) into workspace
+      let nonZeroCount = 0;
       _scatter(a, j, wa, xa, mark);
-      // scatter the values of B(:,j) into workspace
       _scatter(b, j, wb, xb, mark);
+
       // loop rows
-      for (i = 0; i < rows; i++) {
-        // matrix values @ i,j
+      for (let i = 0; i < rows; i++) {
         const va = wa[i] === mark ? xa[i] : zero;
         const vb = wb[i] === mark ? xb[i] : zero;
+
         // invoke callback
-        cdata[i][j] = cf(va, vb);
+        const cij = cf(va, vb);
+        // Store all non zero and true values
+        if (cij !== 0 && cij !== false) {
+          cindex.push(i); // row index
+          cvalues.push(cij); // computed value
+          nonZeroCount++;
+        }
       }
+
+      // Update column pointer with cumulative count of non-zero values
+      cptr[j + 1] = cptr[j] + nonZeroCount;
     }
 
-    // return dense matrix
-    return new DenseMatrix({
-      data: cdata,
+    // Return the result as a sparse matrix
+    return new SparseMatrix({
+      values: cvalues,
+      index: cindex,
+      ptr: cptr,
       size: [rows, columns],
       datatype: adt === a._datatype && bdt === b._datatype ? dt : undefined
     });

package/lib/cjs/type/unit/Unit.js

@@ -3540,7 +3540,7 @@ const createUnitClass = exports.createUnitClass = /* #__PURE__ */(0, _factory.fa
    */
   Unit.typeConverters = {
     BigNumber: function (x) {
-      if (x !== null && x !== void 0 && x.isFraction) return new BigNumber(x.n).div(x.d).times(x.s);
+      if (x !== null && x !== void 0 && x.isFraction) return new BigNumber(String(x.n)).div(String(x.d)).times(String(x.s));
       return new BigNumber(x + ''); // stringify to prevent constructor error
     },
     Fraction: function (x) {

package/lib/cjs/utils/string.js

@@ -80,7 +80,7 @@ function _format(value, options) {
   if (looksLikeFraction(value)) {
     if (!options || options.fraction !== 'decimal') {
       // output as ratio, like '1/3'
-      return value.s * value.n + '/' + value.d;
+      return `${value.s * value.n}/${value.d}`;
     } else {
       // output as decimal, like '0.(3)'
       return value.toString();
@@ -182,7 +182,7 @@ function formatArray(array, options) {
  * @return {boolean}
  */
 function looksLikeFraction(value) {
-  return value && typeof value === 'object' && typeof value.s === 'number' && typeof value.n === 'number' && typeof value.d === 'number' || false;
+  return value && typeof value === 'object' && typeof value.s === 'bigint' && typeof value.n === 'bigint' && typeof value.d === 'bigint' || false;
 }
 
 /**

package/lib/cjs/version.js

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

package/lib/esm/core/function/import.js

@@ -120,6 +120,7 @@ export function importFactory(typed, load, math, importedFactories) {
    * @private
    */
   function _import(name, value, options) {
+    var _math$Unit;
     // TODO: refactor this function, it's to complicated and contains duplicate code
     if (options.wrap && typeof value === 'function') {
       // create a wrapper around the function
@@ -148,7 +149,9 @@ export function importFactory(typed, load, math, importedFactories) {
       });
       return;
     }
-    if (math[name] === undefined || options.override) {
+    var isDefined = math[name] !== undefined;
+    var isValuelessUnit = (_math$Unit = math.Unit) === null || _math$Unit === void 0 ? void 0 : _math$Unit.isValuelessUnit(name);
+    if (!isDefined && !isValuelessUnit || options.override) {
       math[name] = value;
       delete importedFactories[name];
       _importTransform(name, value);

package/lib/esm/core/function/typed.js

@@ -259,7 +259,7 @@ export var createTyped = /* #__PURE__ */factory('typed', dependencies, function
       if (!Fraction) {
         throwNoFraction(x);
       }
-      return new Fraction(x.toString());
+      return new Fraction(x);
     }
   }, {
     from: 'Fraction',

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

@@ -3,12 +3,14 @@
  * DON'T MAKE CHANGES HERE
  */
 import { DenseMatrixDependencies } from './dependenciesDenseMatrixClass.generated.js';
+import { SparseMatrixDependencies } from './dependenciesSparseMatrixClass.generated.js';
 import { concatDependencies } from './dependenciesConcat.generated.js';
 import { matrixDependencies } from './dependenciesMatrix.generated.js';
 import { typedDependencies } from './dependenciesTyped.generated.js';
 import { createBitXor } from '../../factoriesAny.js';
 export var bitXorDependencies = {
   DenseMatrixDependencies,
+  SparseMatrixDependencies,
   concatDependencies,
   matrixDependencies,
   typedDependencies,

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

@@ -3,6 +3,7 @@
  * DON'T MAKE CHANGES HERE
  */
 import { DenseMatrixDependencies } from './dependenciesDenseMatrixClass.generated.js';
+import { SparseMatrixDependencies } from './dependenciesSparseMatrixClass.generated.js';
 import { concatDependencies } from './dependenciesConcat.generated.js';
 import { divideScalarDependencies } from './dependenciesDivideScalar.generated.js';
 import { equalScalarDependencies } from './dependenciesEqualScalar.generated.js';
@@ -11,6 +12,7 @@ import { typedDependencies } from './dependenciesTyped.generated.js';
 import { createDotDivide } from '../../factoriesAny.js';
 export var dotDivideDependencies = {
   DenseMatrixDependencies,
+  SparseMatrixDependencies,
   concatDependencies,
   divideScalarDependencies,
   equalScalarDependencies,

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

@@ -3,6 +3,7 @@
  * DON'T MAKE CHANGES HERE
  */
 import { DenseMatrixDependencies } from './dependenciesDenseMatrixClass.generated.js';
+import { SparseMatrixDependencies } from './dependenciesSparseMatrixClass.generated.js';
 import { concatDependencies } from './dependenciesConcat.generated.js';
 import { equalScalarDependencies } from './dependenciesEqualScalar.generated.js';
 import { matrixDependencies } from './dependenciesMatrix.generated.js';
@@ -11,6 +12,7 @@ import { typedDependencies } from './dependenciesTyped.generated.js';
 import { createDotPow } from '../../factoriesAny.js';
 export var dotPowDependencies = {
   DenseMatrixDependencies,
+  SparseMatrixDependencies,
   concatDependencies,
   equalScalarDependencies,
   matrixDependencies,

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

@@ -3,6 +3,7 @@
  * DON'T MAKE CHANGES HERE
  */
 import { DenseMatrixDependencies } from './dependenciesDenseMatrixClass.generated.js';
+import { SparseMatrixDependencies } from './dependenciesSparseMatrixClass.generated.js';
 import { concatDependencies } from './dependenciesConcat.generated.js';
 import { equalScalarDependencies } from './dependenciesEqualScalar.generated.js';
 import { matrixDependencies } from './dependenciesMatrix.generated.js';
@@ -10,6 +11,7 @@ import { typedDependencies } from './dependenciesTyped.generated.js';
 import { createEqual } from '../../factoriesAny.js';
 export var equalDependencies = {
   DenseMatrixDependencies,
+  SparseMatrixDependencies,
   concatDependencies,
   equalScalarDependencies,
   matrixDependencies,

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

@@ -3,12 +3,14 @@
  * DON'T MAKE CHANGES HERE
  */
 import { DenseMatrixDependencies } from './dependenciesDenseMatrixClass.generated.js';
+import { SparseMatrixDependencies } from './dependenciesSparseMatrixClass.generated.js';
 import { concatDependencies } from './dependenciesConcat.generated.js';
 import { matrixDependencies } from './dependenciesMatrix.generated.js';
 import { typedDependencies } from './dependenciesTyped.generated.js';
 import { createLarger } from '../../factoriesAny.js';
 export var largerDependencies = {
   DenseMatrixDependencies,
+  SparseMatrixDependencies,
   concatDependencies,
   matrixDependencies,
   typedDependencies,

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

@@ -3,12 +3,14 @@
  * DON'T MAKE CHANGES HERE
  */
 import { DenseMatrixDependencies } from './dependenciesDenseMatrixClass.generated.js';
+import { SparseMatrixDependencies } from './dependenciesSparseMatrixClass.generated.js';
 import { concatDependencies } from './dependenciesConcat.generated.js';
 import { matrixDependencies } from './dependenciesMatrix.generated.js';
 import { typedDependencies } from './dependenciesTyped.generated.js';
 import { createLargerEq } from '../../factoriesAny.js';
 export var largerEqDependencies = {
   DenseMatrixDependencies,
+  SparseMatrixDependencies,
   concatDependencies,
   matrixDependencies,
   typedDependencies,

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

@@ -4,11 +4,13 @@
  */
 import { ComplexDependencies } from './dependenciesComplexClass.generated.js';
 import { divideScalarDependencies } from './dependenciesDivideScalar.generated.js';
+import { typeOfDependencies } from './dependenciesTypeOf.generated.js';
 import { typedDependencies } from './dependenciesTyped.generated.js';
 import { createLog } from '../../factoriesAny.js';
 export var logDependencies = {
   ComplexDependencies,
   divideScalarDependencies,
+  typeOfDependencies,
   typedDependencies,
   createLog
 };

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

@@ -13,6 +13,7 @@ import { ParenthesisNodeDependencies } from './dependenciesParenthesisNode.gener
 import { SymbolNodeDependencies } from './dependenciesSymbolNode.generated.js';
 import { equalDependencies } from './dependenciesEqual.generated.js';
 import { parseDependencies } from './dependenciesParse.generated.js';
+import { replacerDependencies } from './dependenciesReplacer.generated.js';
 import { resolveDependencies } from './dependenciesResolve.generated.js';
 import { simplifyConstantDependencies } from './dependenciesSimplifyConstant.generated.js';
 import { simplifyCoreDependencies } from './dependenciesSimplifyCore.generated.js';
@@ -30,6 +31,7 @@ export var simplifyDependencies = {
   SymbolNodeDependencies,
   equalDependencies,
   parseDependencies,
+  replacerDependencies,
   resolveDependencies,
   simplifyConstantDependencies,
   simplifyCoreDependencies,

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

@@ -3,12 +3,14 @@
  * DON'T MAKE CHANGES HERE
  */
 import { DenseMatrixDependencies } from './dependenciesDenseMatrixClass.generated.js';
+import { SparseMatrixDependencies } from './dependenciesSparseMatrixClass.generated.js';
 import { concatDependencies } from './dependenciesConcat.generated.js';
 import { matrixDependencies } from './dependenciesMatrix.generated.js';
 import { typedDependencies } from './dependenciesTyped.generated.js';
 import { createSmaller } from '../../factoriesAny.js';
 export var smallerDependencies = {
   DenseMatrixDependencies,
+  SparseMatrixDependencies,
   concatDependencies,
   matrixDependencies,
   typedDependencies,

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

@@ -3,12 +3,14 @@
  * DON'T MAKE CHANGES HERE
  */
 import { DenseMatrixDependencies } from './dependenciesDenseMatrixClass.generated.js';
+import { SparseMatrixDependencies } from './dependenciesSparseMatrixClass.generated.js';
 import { concatDependencies } from './dependenciesConcat.generated.js';
 import { matrixDependencies } from './dependenciesMatrix.generated.js';
 import { typedDependencies } from './dependenciesTyped.generated.js';
 import { createSmallerEq } from '../../factoriesAny.js';
 export var smallerEqDependencies = {
   DenseMatrixDependencies,
+  SparseMatrixDependencies,
   concatDependencies,
   matrixDependencies,
   typedDependencies,

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

@@ -3,6 +3,7 @@
  * DON'T MAKE CHANGES HERE
  */
 import { DenseMatrixDependencies } from './dependenciesDenseMatrixClass.generated.js';
+import { SparseMatrixDependencies } from './dependenciesSparseMatrixClass.generated.js';
 import { concatDependencies } from './dependenciesConcat.generated.js';
 import { equalScalarDependencies } from './dependenciesEqualScalar.generated.js';
 import { matrixDependencies } from './dependenciesMatrix.generated.js';
@@ -10,6 +11,7 @@ import { typedDependencies } from './dependenciesTyped.generated.js';
 import { createUnequal } from '../../factoriesAny.js';
 export var unequalDependencies = {
   DenseMatrixDependencies,
+  SparseMatrixDependencies,
   concatDependencies,
   equalScalarDependencies,
   matrixDependencies,

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

@@ -3,12 +3,14 @@
  * DON'T MAKE CHANGES HERE
  */
 import { DenseMatrixDependencies } from './dependenciesDenseMatrixClass.generated.js';
+import { SparseMatrixDependencies } from './dependenciesSparseMatrixClass.generated.js';
 import { concatDependencies } from './dependenciesConcat.generated.js';
 import { matrixDependencies } from './dependenciesMatrix.generated.js';
 import { typedDependencies } from './dependenciesTyped.generated.js';
 import { createXor } from '../../factoriesAny.js';
 export var xorDependencies = {
   DenseMatrixDependencies,
+  SparseMatrixDependencies,
   concatDependencies,
   matrixDependencies,
   typedDependencies,

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

@@ -13,6 +13,7 @@ import { ParenthesisNodeDependencies } from './dependenciesParenthesisNode.gener
 import { SymbolNodeDependencies } from './dependenciesSymbolNode.generated.js';
 import { equalDependencies } from './dependenciesEqual.generated.js';
 import { parseDependencies } from './dependenciesParse.generated.js';
+import { replacerDependencies } from './dependenciesReplacer.generated.js';
 import { resolveDependencies } from './dependenciesResolve.generated.js';
 import { simplifyConstantDependencies } from './dependenciesSimplifyConstant.generated.js';
 import { simplifyCoreDependencies } from './dependenciesSimplifyCore.generated.js';
@@ -30,6 +31,7 @@ export var simplifyDependencies = {
   SymbolNodeDependencies,
   equalDependencies,
   parseDependencies,
+  replacerDependencies,
   resolveDependencies,
   simplifyConstantDependencies,
   simplifyCoreDependencies,

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

@@ -172,6 +172,7 @@ export var simplify = createSimplify({
   SymbolNode,
   equal,
   parse,
+  replacer,
   resolve,
   simplifyConstant,
   simplifyCore,

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

@@ -169,6 +169,7 @@ export var simplify = createSimplify({
   SymbolNode,
   equal,
   parse,
+  replacer,
   resolve,
   simplifyConstant,
   simplifyCore,

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

@@ -487,6 +487,7 @@ export var divideScalar = /* #__PURE__ */createDivideScalar({
 });
 export var dotDivide = /* #__PURE__ */createDotDivide({
   DenseMatrix,
+  SparseMatrix,
   concat,
   divideScalar,
   equalScalar,
@@ -495,6 +496,7 @@ export var dotDivide = /* #__PURE__ */createDotDivide({
 });
 export var equal = /* #__PURE__ */createEqual({
   DenseMatrix,
+  SparseMatrix,
   concat,
   equalScalar,
   matrix,
@@ -519,6 +521,7 @@ export var kron = /* #__PURE__ */createKron({
 });
 export var largerEq = /* #__PURE__ */createLargerEq({
   DenseMatrix,
+  SparseMatrix,
   concat,
   config,
   matrix,
@@ -600,6 +603,7 @@ export var round = /* #__PURE__ */createRound({
 });
 export var smaller = /* #__PURE__ */createSmaller({
   DenseMatrix,
+  SparseMatrix,
   concat,
   config,
   matrix,
@@ -635,6 +639,7 @@ export var usolve = /* #__PURE__ */createUsolve({
 });
 export var xor = /* #__PURE__ */createXor({
   DenseMatrix,
+  SparseMatrix,
   concat,
   matrix,
   typed
@@ -671,6 +676,7 @@ export var bitOr = /* #__PURE__ */createBitOr({
 });
 export var bitXor = /* #__PURE__ */createBitXor({
   DenseMatrix,
+  SparseMatrix,
   concat,
   matrix,
   typed
@@ -776,6 +782,7 @@ export var Index = /* #__PURE__ */createIndexClass({
 });
 export var larger = /* #__PURE__ */createLarger({
   DenseMatrix,
+  SparseMatrix,
   concat,
   config,
   matrix,
@@ -785,6 +792,7 @@ export var log = /* #__PURE__ */createLog({
   Complex,
   config,
   divideScalar,
+  typeOf,
   typed
 });
 export var lsolveAll = /* #__PURE__ */createLsolveAll({
@@ -1039,6 +1047,7 @@ export var setPowerset = /* #__PURE__ */createSetPowerset({
 });
 export var smallerEq = /* #__PURE__ */createSmallerEq({
   DenseMatrix,
+  SparseMatrix,
   concat,
   config,
   matrix,
@@ -1052,6 +1061,7 @@ export var sort = /* #__PURE__ */createSort({
 });
 export var unequal = /* #__PURE__ */createUnequal({
   DenseMatrix,
+  SparseMatrix,
   concat,
   config,
   equalScalar,
@@ -1259,6 +1269,7 @@ export var deuteronMass = /* #__PURE__ */createDeuteronMass({
 });
 export var dotPow = /* #__PURE__ */createDotPow({
   DenseMatrix,
+  SparseMatrix,
   concat,
   equalScalar,
   matrix,

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

@@ -1,8 +1,8 @@
 export var ceilDocs = {
   name: 'ceil',
   category: 'Arithmetic',
-  syntax: ['ceil(x)'],
+  syntax: ['ceil(x)', 'ceil(x, n)', 'ceil(unit, valuelessUnit)', 'ceil(unit, n, valuelessUnit)'],
   description: 'Round a value towards plus infinity. If x is complex, both real and imaginary part are rounded towards plus infinity.',
-  examples: ['ceil(3.2)', 'ceil(3.8)', 'ceil(-4.2)'],
+  examples: ['ceil(3.2)', 'ceil(3.8)', 'ceil(-4.2)', 'ceil(3.241cm, cm)', 'ceil(3.241cm, 2, cm)'],
   seealso: ['floor', 'fix', 'round']
 };

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

@@ -1,8 +1,8 @@
 export var fixDocs = {
   name: 'fix',
   category: 'Arithmetic',
-  syntax: ['fix(x)'],
+  syntax: ['fix(x)', 'fix(x, n)', 'fix(unit, valuelessUnit)', 'fix(unit, n, valuelessUnit)'],
   description: 'Round a value towards zero. If x is complex, both real and imaginary part are rounded towards zero.',
-  examples: ['fix(3.2)', 'fix(3.8)', 'fix(-4.2)', 'fix(-4.8)'],
+  examples: ['fix(3.2)', 'fix(3.8)', 'fix(-4.2)', 'fix(-4.8)', 'fix(3.241cm, cm)', 'fix(3.241cm, 2, cm)'],
   seealso: ['ceil', 'floor', 'round']
 };

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

@@ -1,8 +1,8 @@
 export var floorDocs = {
   name: 'floor',
   category: 'Arithmetic',
-  syntax: ['floor(x)'],
+  syntax: ['floor(x)', 'floor(x, n)', 'floor(unit, valuelessUnit)', 'floor(unit, n, valuelessUnit)'],
   description: 'Round a value towards minus infinity.If x is complex, both real and imaginary part are rounded towards minus infinity.',
-  examples: ['floor(3.2)', 'floor(3.8)', 'floor(-4.2)'],
+  examples: ['floor(3.2)', 'floor(3.8)', 'floor(-4.2)', 'floor(3.241cm, cm)', 'floor(3.241cm, 2, cm)'],
   seealso: ['ceil', 'fix', 'round']
 };