Mathematical Functions¶

Original document, see: http://www.lua.org/manual/5.1/manual.html

This library is an interface to the standard C-math library. It provides all its functions inside the table `math`.

math.abs¶

math.abs(x)

Returns the absolute value of `x`.

math.acos¶

math.acos(x)

Returns the arc cosine of `x` (in radians).

math.asin¶

math.asin(x)

Returns the arc sine of `x` (in radians).

math.atan¶

math.atan(x)

Returns the arc tangent of `x` (in radians).

math.atan2¶

math.atan2(y, x)

Returns the arc tangent of `y/x` (in radians), but uses the signs of both parameters to find the quadrant of the result. (It also handles correctly the case of `x` being zero.)

math.ceil¶

math.ceil(x)

Returns the smallest integer larger than or equal to `x`.

math.cos¶

math.cos(x)

Returns the cosine of `x` (assumed to be in radians).

math.cosh¶

math.cosh(x)

Returns the hyperbolic cosine of `x`.

math.deg¶

math.deg(x)

Returns the angle `x` (given in radians) in degrees.

math.exp¶

math.exp(x)

Returns the value e<sup>x</sup>.

math.floor¶

math.floor(x)

Returns the largest integer smaller than or equal to `x`.

math.fmod¶

math.fmod(x, y)

Returns the remainder of the division of `x` by `y` that rounds the quotient towards zero.

math.frexp¶

math.frexp(x)

Returns `m` and `e` such that x = m2^e, `e` is an integer and the absolute value of `m` is in the range [0.5, 1) (or zero when `x` is zero).

math.huge¶

math.huge

The value `HUGE_VAL`, a value larger than or equal to any other numerical value.

math.ldexp¶

math.ldexp(m, e)

Returns m2^e (`e` should be an integer).

math.log¶

math.log(x)

Returns the natural logarithm of `x`.

math.log10¶

math.log10(x)

Returns the base-10 logarithm of `x`.

math.max¶

math.max(x, ...)

Returns the maximum value among its arguments.

math.min¶

math.min(x, ...)

Returns the minimum value among its arguments.

math.modf¶

math.modf(x)

Returns two numbers, the integral part of `x` and the fractional part of `x`.

math.pi

The value of pi.

math.pow¶

math.pow(x, y)

Returns x^y. (You can also use the expression `x^y` to compute this value.)

Returns the angle `x` (given in degrees) in radians.

math.random¶

math.random([m[, n]])

This function is an interface to the simple pseudo-random generator function `rand` provided by ANSI-C. (No guarantees can be given for its statistical properties.)

When called without arguments, returns a uniform pseudo-random real number in the range [0,1). When called with an integer number `m`, `math.random` returns a uniform pseudo-random integer in the range [1, m]. When called with two integer numbers `m` and `n`, `math.random` returns a uniform pseudo-random integer in the range [m, n].

math.randomseed¶

math.randomseed(x)

Sets `x` as the “seed” for the pseudo-random generator: equal seeds produce equal sequences of numbers.

math.sin¶

math.sin(x)

Returns the sine of `x` (assumed to be in radians).

math.sinh¶

math.sinh(x)

Returns the hyperbolic sine of `x`.

math.sqrt¶

math.sqrt(x)

Returns the square root of `x`. (You can also use the expression `x^0.5` to compute this value.)

math.tan¶

math.tan(x)

Returns the tangent of `x` (assumed to be in radians).

math.tanh¶

math.tanh(x)

Returns the hyperbolic tangent of `x`.

id-2099528