mathjs/lib/esm/function/fraction/den.js

Math.js is an extensive math library for JavaScript and Node.js. It features a flexible expression parser with support for symbolic computation, comes with a large set of built-in functions and constants, and offers an integrated solution to work with dif

import { factory } from '../../utils/factory.js';
import { deepMap } from '../../utils/collection.js';
var name = 'den';
var dependencies = ['typed', 'fraction'];
export var createDen = /* #__PURE__ */factory(name, dependencies, _ref => {
  var {
    typed,
    fraction
  } = _ref;
  /**
   * Get the denominator of a fraction.
   * For a fraction `a/b`, the function returns `b`.
   *
   * The result is always in lowest terms. For example, `den(fraction(8, 6))`
   * returns `3n` because 8/6 simplifies to 4/3.
   *
   * For negative fractions like `-a/b` or `a/-b`, the denominator is
   * always returned as a positive bigint. The sign is stored in the
   * numerator. So `den(fraction(-2, 3))` and `den(fraction(2, -3))`
   * both return `3n`.
   *
   * For matrices, the function is evaluated element wise.
   *
   * Syntax:
   *
   *    math.den(x)
   *
   * Examples:
   *
   *    math.den(math.fraction(2, 3))   // returns 3n
   *    math.den(math.fraction(8, 6))   // returns 3n
   *    math.den(math.fraction('5/8'))  // returns 8n
   *    math.den(math.fraction(-2, 3))  // returns 3n
   *    math.den(math.fraction(2, -3))  // returns 3n
   *    math.den(math.bignumber('0.5'))  // returns 2n
   *
   * See also:
   *
   *    num, fraction
   *
   * History:
   *
   *    v15.2.0      Created
   *
   * @param {Fraction | BigNumber | Array | Matrix} x
   *            A fraction, BigNumber, or array with fractions
   * @return {bigint | Array | Matrix} The denominator of x (in lowest terms)
   */
  return typed(name, {
    Fraction: x => x.d,
    BigNumber: x => fraction(x).d,
    'Array | Matrix': typed.referToSelf(self => x => deepMap(x, self))
  });
});