数学方法 (math)

下面按编号列出 math 库的所有函数。每个函数使用统一模板并包含参数表与返回值表（样式参考你的截图）。

---

1. math.abs (绝对值)

函数: math.abs(number)说明: 返回数值的绝对值

参数:

参数名	类型	必填	说明
number	number	是	要取绝对值的数

返回值:

返回值类型	说明
number	number 的绝对值

示例:

print(math.abs(-15)) -- 15

---

2. math.asin (反正弦)

函数: math.asin(number)说明: 返回数值的反正弦值

参数:

参数名	类型	必填	说明
number	number	是	范围 -1..1

返回值:

返回值类型	说明
number	以弧度表示的反正弦值

示例:

print(math.asin(0.5))

---

3. math.acos (反余弦)

函数: math.acos(number)说明: 返回数值的反余弦值

参数:

参数名	类型	必填	说明
number	number	是	范围 -1..1

返回值:

返回值类型	说明
number	以弧度表示的反余弦值

示例:

print(math.acos(0.5))

---

4. math.atan (反正切)

函数: math.atan(number)说明: 返回数值的反正切值

参数:

参数名	类型	必填	说明
number	number	是	任意数值表达式

返回值:

返回值类型	说明
number	以弧度表示的反正切值

示例:

print(math.atan(1)) -- ~0.7854 (π/4)

---

5. math.ceil (向上取整)

函数: math.ceil(number)说明: 返回不小于数值的最小整数

参数:

参数名	类型	必填	说明
number	number	是	任意数值表达式

返回值:

返回值类型	说明
integer	不小于 number 的最小整数

示例:

print(math.ceil(3.1)) -- 4

---

6. math.cos (余弦)

函数: math.cos(rad)说明: 返回角度的余弦值

参数:

参数名	类型	必填	说明
rad	number	是	弧度

返回值:

返回值类型	说明
number	余弦值

示例:

print(math.cos(math.rad(30)))

---

7. math.deg (弧度转角度)

函数: math.deg(rad)说明: 将弧度转换为角度

参数:

参数名	类型	必填	说明
rad	number	是	弧度

返回值:

返回值类型	说明
number	对应的角度值

示例:

print(math.deg(math.pi)) -- 180.0

---

8. math.exp (指数)

函数: math.exp(x)说明: 返回e的x次方

参数:

参数名	类型	必填	说明
x	number	是	指数值 x

返回值:

返回值类型	说明
number	e^x 的值

示例:

print(math.exp(1)) -- e

---

9. math.floor (向下取整)

函数: math.floor(number)说明: 返回不大于数值的最大整数

参数:

参数名	类型	必填	说明
number	number	是	任意数值表达式

返回值:

返回值类型	说明
integer	不大于 number 的最大整数

示例:

print(math.floor(3.9)) -- 3

---

10. math.log (自然对数)

函数: math.log(x)说明: 返回数值的自然对数

参数:

参数名	类型	必填	说明
x	number	是	要求自然对数的数值

返回值:

返回值类型	说明
number	ln(x)

示例:

print(math.log(10))

---

11. math.max (取得参数中最大值)

函数: math.max(number1, number2, ...)说明: 取得参数中的最大值

参数:

参数名	类型	必填	说明
number1	number	是	第一个数
number2	number	是	第二个数
...	number	否	可变参数

返回值:

返回值类型	说明
number	参数列表中的最大值

示例:

print(math.max(1, 10, 5)) -- 10

---

12. math.min (取得参数中最小值)

函数: math.min(number1, number2, ...)说明: 取得参数中的最小值

参数:

参数名	类型	必填	说明
number1	number	是	第一个数
number2	number	是	第二个数
...	number	否	可变参数

返回值:

返回值类型	说明
number	参数列表中的最小值

示例:

print(math.min(1, 10, 5)) -- 1

---

13. math.fmod (取余数)

函数: math.fmod(dividend, divisor)说明: 取得两个数相除的余数

参数:

参数名	类型	必填	说明
dividend	number	是	被除数
divisor	number	是	除数

返回值:

返回值类型	说明
number	余数

示例:

print(math.fmod(10, 3)) -- 1

---

14. math.modf (分离整数与小数部分)

函数: math.modf(number)说明: 分离数值的整数与小数部分

参数:

参数名	类型	必填	说明
number	number	是	要拆分的数

返回值:

返回值类型	说明
integer	整数部分
number	小数部分

示例:

local i, f = math.modf(3.14)
print(i, f) -- 3 0.14

---

15. math.randomseed (设置随机种子)

函数: math.randomseed(seed)说明: 设置随机数生成器的种子

参数:

参数名	类型	必填	说明
seed	number	是	种子值（通常用时间）

返回值:

返回值类型	说明
无

示例:

math.randomseed(os.time())

---

16. math.random (产生随机数)

函数:

• math.random() — 返回 [0,1) 的小数
• math.random(upper) — 返回 [1, upper] 的整数
• math.random(low, high) — 返回 [low, high] 的整数

说明: 产生随机数

参数表（可变）：

参数名	类型	必填	说明
low	integer	否	下限
high / upper	integer	否/视形式而定	上限

返回值:

返回值类型	说明
number/integer	依据调用形式返回小数或整数

示例:

print(math.random())
print(math.random(100))
print(math.random(10, 20))

---

17. math.rad (角度转弧度)

函数: math.rad(deg)说明: 将角度转换为弧度

参数:

参数名	类型	必填	说明
deg	number	是	角度

返回值:

返回值类型	说明
number	对应的弧度

示例:

print(math.rad(180)) -- π

---

18. math.sin (正弦)

函数: math.sin(rad)说明: 返回角度的正弦值

参数:

参数名	类型	必填	说明
rad	number	是	弧度

返回值:

返回值类型	说明
number	正弦值

示例:

print(math.sin(math.rad(30)))

---

19. math.sqrt (平方根)

函数: math.sqrt(number)说明: 返回数值的平方根

参数:

参数名	类型	必填	说明
number	number	是	要开根号的数

返回值:

返回值类型	说明
number	平方根

示例:

print(math.sqrt(9)) -- 3.0

---

20. math.tan (正切)

函数: math.tan(rad)说明: 返回角度的正切值

参数:

参数名	类型	必填	说明
rad	number	是	弧度

返回值:

返回值类型	说明
number	正切值

示例:

print(math.tan(math.rad(30)))

---

21. math.pi (圆周率常量)

函数: math.pi说明: 圆周率π的近似值

参数: 无

返回值:

返回值类型	说明
number	π 的近似值

示例:

print(math.pi)

---

22. math.tointeger (转化为整数)

函数: math.tointeger(x)说明: 将值转换为整数

参数:

参数名	类型	必填	说明
x	number	string	是

返回值:

返回值类型	说明
integer	转换后的整数，或 nil

示例:

print(math.tointeger(3.0)) -- 3
print(math.tointeger("666")) -- 666

---

23. math.type (获取数字类型)

函数: math.type(x)说明: 获取数字的类型

参数:

参数名	类型	必填	说明
x	number	是	待检测的数

返回值:

返回值类型	说明
string	"integer" / "float" 或 nil

示例:

print(math.type(3))    -- "integer"
print(math.type(3.14)) -- "float"

---

24. math.ult (无符号比较)

函数: math.ult(m, n)说明: 无符号比较两个整数

参数:

参数名	类型	必填	说明
m	integer	是	被比较的整数
n	integer	是	被比较的整数

返回值:

返回值类型	说明
boolean	若 m < n（按无符号比较）则为 true

示例:

print(math.ult(6, 8)) -- true

---