模块 lib.util
工具函数。
函数
| dbamp (db) | 分贝转振幅。 |
| time () | 获取系统时间（小数秒） |
| scandir (directory) | 扫描目录，返回文件列表。 |
| file_exists (name) | 检查文件是否存在。 |
| file_size (path) | 查询文件大小。 |
| make_dir (path) | 创建目录（必要时创建父目录）。 |
| os_capture (cmd, raw) | 执行操作系统命令，捕获输出。 |
| string_开始s (s, 开始) | 字符串以...开始。 |
| trim_string_to_width (s, width) | 将字符串裁剪到显示宽度 |
| clamp (n, min, max) | 将值限制在最小最大值之间。 |
| linexp (slo, shi, dlo, dhi, f) | 将线性范围转换为指数范围 |
| linlin (slo, shi, dlo, dhi, f) | 将线性范围映射到另一个线性范围。 |
| explin (slo, shi, dlo, dhi, f) | 将指数范围转换为线性范围。 |
| expexp (slo, shi, dlo, dhi, f) | 将指数范围映射到另一个指数范围。 |
| round (number, quant) | 四舍五入到数字的倍数 |
| round_up (number, quant) | 向上取整到数字的倍数。 |
| s_to_hms (s) | 格式化字符串，秒转时:分:秒。 |
| degs_to_rads (degrees) | 将角度转换为弧度 |
| rads_to_degs (radians) | 将弧度转换为角度 |
| acronym (name) | 将字符串转换为缩写 |
| wrap (n, min, max) | 将整数包装到正的min/max范围内 |
| wrap_max (n, min, max) | 将整数包装到正的min/max范围内，但限制最小值 |
函数
- dbamp (db)
-
分贝转振幅。
参数:
- db number
返回:
-
number
振幅
- time ()
-
获取系统时间（小数秒）
返回:
-
时间
- scandir (directory)
-
扫描目录，返回文件列表。
参数:
- directory string 目录路径
返回:
- file_exists (name)
-
检查文件是否存在。
参数:
- name string 文件路径
返回:
-
boolean
true/false
- file_size (path)
-
查询文件大小。
参数:
- path string 文件路径
返回:
-
number
文件大小（字节）
- make_dir (path)
-
创建目录（必要时创建父目录）。
参数:
- path string
- os_capture (cmd, raw)
-
执行操作系统命令，捕获输出。
参数:
- cmd string 命令
- raw 原始输出（省略则为清理后输出）
返回:
-
输出
- string_开始s (s, 开始)
-
字符串以...开始。
参数:
返回:
-
boolean
真或假
- trim_string_to_width (s, width)
-
将字符串裁剪到显示宽度
参数:
- s string 要裁剪的字符串
- width number 最大宽度
返回:
-
string
裁剪后的字符串
- clamp (n, min, max)
-
将值限制在最小最大值之间。
参数:
- n number 数值
- min number 最小值
- max number 最大值
返回:
-
number
限制后的值
- linexp (slo, shi, dlo, dhi, f)
-
将线性范围转换为指数范围
参数:
- slo number 输入范围下限
- shi number 输入范围上限
- dlo number 输出范围下限（必须非零且与dhi同号）
- dhi number 输出范围上限（必须非零且与dlo同号）
- f number 要转换的输入值
返回:
-
number
- linlin (slo, shi, dlo, dhi, f)
-
将线性范围映射到另一个线性范围。
参数:
- slo number 输入范围下限
- shi number 输入范围上限
- dlo number 输出范围下限
- dhi number 输出范围上限
- f number 要转换的输入值
返回:
-
number
- explin (slo, shi, dlo, dhi, f)
-
将指数范围转换为线性范围。
参数:
- slo number 输入范围下限（必须非零且与shi同号）
- shi number 输入范围上限（必须非零且与slo同号）
- dlo number 输出范围下限
- dhi number 输出范围上限
- f number 要转换的输入值
返回:
-
number
- expexp (slo, shi, dlo, dhi, f)
-
将指数范围映射到另一个指数范围。
参数:
- slo number 输入范围下限（必须非零且与shi同号）
- shi number 输入范围上限（必须非零且与slo同号）
- dlo number 输出范围下限（必须非零且与dhi同号）
- dhi number 输出范围上限（必须非零且与dlo同号）
- f number 要转换的输入值
返回:
-
number
- round (number, quant)
-
四舍五入到数字的倍数
参数:
- number number 要四舍五入的数字
- quant number 四舍五入的精度
- round_up (number, quant)
-
向上取整到数字的倍数。
参数:
- number number 要四舍五入的数字
- quant number 四舍五入的精度
- s_to_hms (s)
-
格式化字符串，秒转时:分:秒。
参数:
- s number 秒数
返回:
-
string
秒数：以时:分:秒格式的秒数
- degs_to_rads (degrees)
-
将角度转换为弧度
参数:
- degrees number
返回:
-
number
弧度
- rads_to_degs (radians)
-
将弧度转换为角度
参数:
- radians number
返回:
-
number
角度
- acronym (name)
-
将字符串转换为缩写
参数:
- name string
返回:
-
string
缩写
- wrap (n, min, max)
-
将整数包装到正的最小/最大范围内
参数:
- n integer
- min integer
- max integer
返回:
-
integer
循环后的值
- wrap_max (n, min, max)
-
将整数包装到正的最小/最大范围内，但限制最小值
参数:
- n integer
- min integer
- max integer
返回:
-
integer
循环后的值