Version: latest - a1.64.x ⚖️

# math

This library provides basic mathematical functions. It provides all its functions and constants inside the table `math`.

🧑‍💻API Source
This page is auto-generated! The Functions, Properties and Events described here are defined in our GitHub's API Repository! Feel free to commit suggestions and changes to the source .json API files!

## 🎒 Examples​

``TODO Examples``

## 🗼 Static Properties​

ValueName
`3.141592653589793``math.pi`
`2^1024``math.huge`

## 🗿 Static Functions​

ReturnsNameDescription
number`ceil`Return the integer no greater than the given value (even for negatives)
number`tan`Return the tangent value for a given value in radians.
number`min`Return the minimum value from a variable length list of arguments
number`fmod`Returns the remainder of the division of `base` by `modulator` that rounds the quotient towards zero
number`exp`Returns e (the base of natural logarithms) raised to the power `exponent`
number`random`Generates pseudo-random numbers uniformly distributed
number`rad`Convert from degrees to radians
number`sin`Return the sine value for a given value in radians.
number`cos`Return the cosine value for a given value in radians.
number`asin`Return the inverse sine in radians of the given value.
`randomseed`Sets a seed for the pseudo-random generator: Equal seeds produce equal sequences of numbers
number`floor`Return the integer no less than the given value (even for negatives)
number`max`Return the maximum value from a variable length list of arguments
number`atan`Return the inverse tangent in radians. We can do this by supplying y/x ourselves or we can pass y and x to math.atan to do this for us
number`acos`Return the inverse cosine in radians of the given value.
number`abs`Return the absolute, or non-negative value, of a given value
number`log`Returns the inverse of this. `math.exp(1)` returns `e`
number, number`modf`Return the integral and fractional parts of the given number
number`deg`Convert from radians to degrees
number`sqrt`Return the square root of a given number. Only non-negative arguments are allowed

### `ceil`

Return the integer no greater than the given value (even for negatives)

— Returns number.

``local ret = math.ceil(number)``
TypeParameterDefaultDescription
number`number` Required parameter The number to be rounded up.

### `tan`

Return the tangent value for a given value in radians.

— Returns number.

``local ret = math.tan(value)``
TypeParameterDefaultDescription
number`value` Required parameter Angle in radians

### `min`

Return the minimum value from a variable length list of arguments

— Returns number.

``local ret = math.min(numbers...)``
TypeParameterDefaultDescription
`numbers...` Required parameter Numbers to get the smallest from.

### `fmod`

Returns the remainder of the division of `base` by `modulator` that rounds the quotient towards zero

— Returns number.

``local ret = math.fmod(base, modulator)``
TypeParameterDefaultDescription
number`base` Required parameter The base value.
number`modulator` Required parameter The modulator.

### `exp`

Returns e (the base of natural logarithms) raised to the power `exponent`

— Returns number.

``local ret = math.exp(exponent)``
TypeParameterDefaultDescription
number`exponent` Required parameter The exponent for the function.

### `random`

Generates pseudo-random numbers uniformly distributed

— Returns number.

``local ret = math.random(m, n)``
TypeParameterDefaultDescription
number`m` Required parameter If m is the only parameter: upper limit. If n is also provided: lower limit. If provided, this must be an integer.
number`n` Required parameter Upper limit. If provided, this must be an integer.

### `rad`

— Returns number.

``local ret = math.rad(degrees)``
TypeParameterDefaultDescription
number`degrees` Required parameter The angle measured in degrees.

### `sin`

Return the sine value for a given value in radians.

— Returns number.

``local ret = math.sin(number)``
TypeParameterDefaultDescription
number`number` Required parameter Angle in radians

### `cos`

Return the cosine value for a given value in radians.

— Returns number.

``local ret = math.cos(number)``
TypeParameterDefaultDescription
number`number` Required parameter Angle in radians

### `asin`

Return the inverse sine in radians of the given value.

— Returns number.

``local ret = math.asin(normal)``
TypeParameterDefaultDescription
number`normal` Required parameter Sine value in the range of -1 to 1.

### `randomseed`

Sets a seed for the pseudo-random generator: Equal seeds produce equal sequences of numbers

``math.randomseed(seed)``
TypeParameterDefaultDescription
number`seed` Required parameter The new seed

### `floor`

Return the integer no less than the given value (even for negatives)

— Returns number.

``local ret = math.floor(number)``
TypeParameterDefaultDescription
number`number` Required parameter The number to be rounded down.

### `max`

Return the maximum value from a variable length list of arguments

— Returns number.

``local ret = math.max(numbers...)``
TypeParameterDefaultDescription
`numbers...` Required parameter Numbers to get the largest from

### `atan`

Return the inverse tangent in radians. We can do this by supplying y/x ourselves or we can pass y and x to math.atan to do this for us

— Returns number.

``local ret = math.atan(normal)``
TypeParameterDefaultDescription
number`normal` Required parameter Tangent value.

### `acos`

Return the inverse cosine in radians of the given value.

— Returns number.

``local ret = math.acos(cos)``
TypeParameterDefaultDescription
number`cos` Required parameter Cosine value in range of -1 to 1.

### `abs`

Return the absolute, or non-negative value, of a given value

— Returns number.

``local ret = math.abs(x)``
TypeParameterDefaultDescription
number`x` Required parameter The number to get the absolute value of.

### `log`

Returns the inverse of this. `math.exp(1)` returns `e`

— Returns number.

``local ret = math.log(x, base)``
TypeParameterDefaultDescription
number`x` Required parameter The value to get the base from exponent from.
number`base` Required parameter The logarithmic base.

### `modf`

Return the integral and fractional parts of the given number

— Returns number, number (, ).

``local ret_01, ret_02 = math.modf(base)``
TypeParameterDefaultDescription
number`base` Required parameter The base value.

### `deg`

— Returns number.

``local ret = math.deg(radians)``
TypeParameterDefaultDescription
number`radians` Required parameter Value to be converted to degrees.

### `sqrt`

Return the square root of a given number. Only non-negative arguments are allowed

— Returns number.

``local ret = math.sqrt(value)``
TypeParameterDefaultDescription
number`value` Required parameter Value to get the square root of.