mathjs/docs/reference/functions/lcm.md

Math.js is an extensive math library for JavaScript and Node.js. It features a flexible expression parser and offers an integrated solution to work with numbers, big numbers, complex numbers, units, and matrices.

# Function lcm

Calculate the least common multiple for two or more values or arrays.

lcm is defined as:

    lcm(a, b) = abs(a * b) / gcd(a, b)

For matrices, the function is evaluated element wise.


## Syntax

```js
math.lcm(a, b)
math.lcm(a, b, c, ...)
```

### Parameters

Parameter | Type | Description
--------- | ---- | -----------
`args` | ... Number | BigNumber | Boolean | Array | Matrix | null | Two or more integer numbers

### Returns

Type | Description
---- | -----------
Number | BigNumber | Array | Matrix | The least common multiple


## Examples

```js
math.lcm(4, 6);               // returns 12
math.lcm(6, 21);              // returns 42
math.lcm(6, 21, 5);           // returns 210

math.lcm([4, 6], [6, 21]);    // returns [12, 42]
```


## See also

[gcd](gcd.md),
[xgcd](xgcd.md)


<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->