Function round #
Round a value towards the nearest rounded value. For matrices, the function is evaluated element wise.
Syntax #
math.round(x)
math.round(x, n)
math.round(unit, valuelessUnit)
math.round(unit, n, valuelessUnit)
Parameters #
Parameter | Type | Description |
---|---|---|
x |
number | BigNumber | Fraction | Complex | Unit | Array | Matrix | Value to be rounded |
n |
number | BigNumber | Array | Number of decimals Default value: 0. |
valuelessUnit |
Unit | A valueless unit |
Returns #
Type | Description |
---|---|
number | BigNumber | Fraction | Complex | Unit | Array | Matrix | Rounded value |
Throws #
Type | Description —- | ———–
Examples #
math.round(3.22) // returns number 3
math.round(3.82) // returns number 4
math.round(-4.2) // returns number -4
math.round(-4.7) // returns number -5
math.round(3.22, 1) // returns number 3.2
math.round(3.88, 1) // returns number 3.9
math.round(-4.21, 1) // returns number -4.2
math.round(-4.71, 1) // returns number -4.7
math.round(math.pi, 3) // returns number 3.142
math.round(123.45678, 2) // returns number 123.46
const c = math.complex(3.2, -2.7)
math.round(c) // returns Complex 3 - 3i
const unit = math.unit('3.241 cm')
const cm = math.unit('cm')
const mm = math.unit('mm')
math.round(unit, 1, cm) // returns Unit 3.2 cm
math.round(unit, 1, mm) // returns Unit 32.4 mm
math.round([3.2, 3.8, -4.7]) // returns Array [3, 4, -5]