math

该库提供基础数学函数。它在 math 表中提供其所有函数和常量。

🧑‍💻API Source

---

🎒 示例

-- Rounding
local a = math.floor(3.7) -- 3
local b = math.ceil(3.2)  -- 4

-- Random numbers
local chance = math.random()          -- float between 0 and 1
local dice = math.random(1, 6)        -- integer between 1 and 6

-- Min, Max and Absolute
local lowest = math.min(10, 5, 8)     -- 5
local distance = math.abs(-250)       -- 250

-- Trigonometry works with radians
local sine = math.sin(math.rad(90))   -- 1.0

🗼 静态属性

Value	Name
3.141592653589793	math.pi
2^1024	math.huge

🗿 静态函数

	Returns	Name	Description
	number	ceil	返回大于或等于给定值的最小整数
	number	tan	返回给定弧度值的正切值。
	number	min	返回可变长度参数列表中的最小值
	number	fmod	返回 base 除以 modulator 的余数，该操作会将商向零取整
	number	exp	返回 e（自然对数的底数）的 exponent 次幂
	number	random	生成均匀分布的伪随机数
	number	rad	将角度转换为弧度
	number	sin	返回给定弧度值的正弦值。
	number	cos	返回给定弧度值的余弦值。
	number	asin	返回给定值的反正弦值（弧度）。
		randomseed	为伪随机数生成器设置种子：相同的种子产生相同的数字序列值
	number	floor	返回小于或等于给定值的最大整数
	number	max	返回可变长度参数列表中的最大值
	number	atan	返回以弧度表示的反切值。传入 y 和 x 可获取点 (x, y) 的角度，并结合两者的符号确定象限
	number	acos	返回给定值的反余弦值（弧度）。
	number	abs	返回给定值的绝对值或非负值
	number	log	返回 x 在指定底数下的对数。默认底数为 e（自然对数）
	number, number	modf	返回给定数字的整数部分和分数部分
	number	deg	将弧度转换为角度
	number	sqrt	返回给定数字的平方根。仅允许非负参数

---

ceil

返回大于或等于给定值的最小整数

local ret = math.ceil(number)

Parameters

Type	Parameter	Default	Description
number	number	Required parameter	要向上取整的数字。

Returns

Type	Description
number	向上取整后的整数

---

tan

返回给定弧度值的正切值。

local ret = math.tan(value)

Parameters

Type	Parameter	Default	Description
number	value	Required parameter	以弧度为单位的角

Returns

Type	Description
number	正切值

---

min

返回可变长度参数列表中的最小值

local ret = math.min(numbers...)

Parameters

Type	Parameter	Default	Description
varargs of number	numbers...	Required parameter	要从中获取最小值的数字列表。

Returns

Type	Description
number	最小值

---

fmod

返回 base 除以 modulator 的余数，该操作会将商向零取整

local ret = math.fmod(base, modulator)

Parameters

Type	Parameter	Default	Description
number	base	Required parameter	被除数。
number	modulator	Required parameter	除数。

Returns

Type	Description
number	余数

---

exp

返回 e（自然对数的底数）的 exponent 次幂

local ret = math.exp(exponent)

Parameters

Type	Parameter	Default	Description
number	exponent	Required parameter	函数的指数。

Returns

Type	Description
number	e 的指定次幂

---

random

生成均匀分布的伪随机数

local ret = math.random(m, n)

Parameters

Type	Parameter	Default	Description
number	m	Required parameter	如果 m 是唯一的参数：上限。 如果同时提供了 n：下限。 如果提供，这必须是一个整数。
number	n	Required parameter	上限。 如果提供，这必须是一个整数。

Returns

Type	Description
number	无参数调用时返回 0 到 1 之间的随机浮点数，否则返回指定范围内的随机整数

---

rad

将角度转换为弧度

local ret = math.rad(degrees)

Parameters

Type	Parameter	Default	Description
number	degrees	Required parameter	以度为单位测量的角度。

Returns

Type	Description
number	以弧度表示的角度

---

sin

返回给定弧度值的正弦值。

local ret = math.sin(number)

Parameters

Type	Parameter	Default	Description
number	number	Required parameter	以弧度为单位的角

Returns

Type	Description
number	正弦值

---

cos

返回给定弧度值的余弦值。

local ret = math.cos(number)

Parameters

Type	Parameter	Default	Description
number	number	Required parameter	以弧度为单位的角

Returns

Type	Description
number	余弦值

---

asin

返回给定值的反正弦值（弧度）。

local ret = math.asin(normal)

Parameters

Type	Parameter	Default	Description
number	normal	Required parameter	-1 到 1 范围内的正弦值。

Returns

Type	Description
number	以弧度表示的角度

---

randomseed

为伪随机数生成器设置种子：相同的种子产生相同的数字序列值

math.randomseed(seed)

Parameters

Type	Parameter	Default	Description
number	seed	Required parameter	新的种子

---

floor

返回小于或等于给定值的最大整数

local ret = math.floor(number)

Parameters

Type	Parameter	Default	Description
number	number	Required parameter	要向下取整的数字。

Returns

Type	Description
number	向下取整后的整数

---

max

返回可变长度参数列表中的最大值

local ret = math.max(numbers...)

Parameters

Type	Parameter	Default	Description
varargs of number	numbers...	Required parameter	要从中获取最大值的数字列表

Returns

Type	Description
number	最大值

---

atan

返回以弧度表示的反切值。传入 y 和 x 可获取点 (x, y) 的角度，并结合两者的符号确定象限

local ret = math.atan(normal)

Parameters

Type	Parameter	Default	Description
number	normal	Required parameter	正切值。

Returns

Type	Description
number	以弧度表示的角度

---

acos

返回给定值的反余弦值（弧度）。

local ret = math.acos(cos)

Parameters

Type	Parameter	Default	Description
number	cos	Required parameter	-1 到 1 范围内的余弦值。

Returns

Type	Description
number	以弧度表示的角度

---

abs

返回给定值的绝对值或非负值

local ret = math.abs(x)

Parameters

Type	Parameter	Default	Description
number	x	Required parameter	要获取绝对值的数字。

Returns

Type	Description
number	绝对值

---

log

返回 x 在指定底数下的对数。默认底数为 e（自然对数）

local ret = math.log(x, base)

Parameters

Type	Parameter	Default	Description
number	x	Required parameter	要获取其以指定底数为基数的对数值。
number	base	Required parameter	对数的底数。

Returns

Type	Description
number	对数值

---

modf

返回给定数字的整数部分和分数部分

local ret_1, ret_2 = math.modf(base)

Parameters

Type	Parameter	Default	Description
number	base	Required parameter	被除数。

Returns

Type	Description
number	整数部分
number	小数部分

---

deg

将弧度转换为角度

local ret = math.deg(radians)

Parameters

Type	Parameter	Default	Description
number	radians	Required parameter	要转换为角度的弧度值。

Returns

Type	Description
number	角度（度）

---

sqrt

返回给定数字的平方根。仅允许非负参数

local ret = math.sqrt(value)

Parameters

Type	Parameter	Default	Description
number	value	Required parameter	要获取平方根的值。

Returns

Type	Description
number	平方根