csh/playbook
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

📝 docs(tsl): restructure agent-facing reference

Browse Source 
Rework TSL syntax, catalog, modules, and routing docs around deterministic agent lookup and generation.

Split large catalog pages into focused function fact pages, remove obsolete pending/verified/unavailable paths, and update consistency tests for the new structure.
This commit is contained in:
csh
2026-06-09 17:24:30 +08:00
parent 9c194170a1
commit 540b3c0a1b
192 changed files with 32929 additions and 13533 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/tsl/reference/catalog/math/elementary_math.md
+652
View File
@@ -0,0 +1,652 @@
# 数学函数 - 初等数学与判断
文档类型：函数事实页
是否可直接用于生成代码：是；本页函数条目均包含参数表
遇到不确定时：回到 [../math.md](../math.md)、[../../index.md](../../index.md)
本页收录常用数学、指数对数、精度取整、比较判断和位运算函数。
## 常用数学函数
### `pi()`
用途：常用数学函数相关函数。
参数个数：0
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | ---- |
### `odd(arg1)`
用途：常用数学函数相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 整数 | 按源文档示例顺序传入 |
### `abs(arg1)`
用途：常用数学函数相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 整数 | 按源文档示例顺序传入 |
### `sqr(x)`
用途：常用数学函数相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `x` | 是 | 整数 | 按源文档示例顺序传入 |
### `sqrt(x)`
用途：常用数学函数相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `x` | 是 | 数组 | 按源文档示例顺序传入 |
### `divMod(arg1, arg2, a, b)`
用途：常用数学函数相关函数。
参数个数：4
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------------------------------- |
| 1 | `arg1` | 是 | 整数 | 按源文档示例顺序传入 |
| 2 | `arg2` | 是 | 整数 | 按源文档示例顺序传入 |
| 3 | `a` | 是 | 任意值 | 按源文档示例顺序传入；源文档示例传入变量 `a` |
| 4 | `b` | 是 | 任意值 | 按源文档示例顺序传入；源文档示例传入变量 `b` |
### `frexp(x, base, exponent)`
用途：常用数学函数相关函数。
参数个数：3
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ---------- | ---- | -------- | --------------------------------------------------- |
| 1 | `x` | 是 | 任意值 | 按源文档示例顺序传入 |
| 2 | `base` | 是 | 任意值 | 按源文档示例顺序传入；源文档示例传入变量 `Base` |
| 3 | `exponent` | 是 | 任意值 | 按源文档示例顺序传入；源文档示例传入变量 `Exponent` |
### `ldexp(arg1, arg2)`
用途：常用数学函数相关函数。
参数个数：2
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 整数 | 按源文档示例顺序传入 |
| 2 | `arg2` | 是 | 整数 | 按源文档示例顺序传入 |
### `poly(x, a)`
用途：常用数学函数相关函数。
参数个数：2
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `x` | 是 | 整数 | 按源文档示例顺序传入 |
| 2 | `a` | 是 | 数组 | 按源文档示例顺序传入 |
## 指数对数函数
### `ln(arg1)`
用途：指数对数函数相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
### `lnXP1(arg1)`
用途：指数对数函数相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 整数 | 按源文档示例顺序传入 |
### `log10(arg1)`
用途：指数对数函数相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 整数 | 按源文档示例顺序传入 |
### `log2(arg1)`
用途：指数对数函数相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 整数 | 按源文档示例顺序传入 |
### `logN(arg1, arg2)`
用途：指数对数函数相关函数。
参数个数：2
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 整数 | 按源文档示例顺序传入 |
| 2 | `arg2` | 是 | 整数 | 按源文档示例顺序传入 |
### `exp(arg1)`
用途：指数对数函数相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 整数 | 按源文档示例顺序传入 |
### `intPower(arg1, arg2)`
用途：指数对数函数相关函数。
参数个数：2
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 整数 | 按源文档示例顺序传入 |
| 2 | `arg2` | 是 | 实数 | 按源文档示例顺序传入 |
### `power(arg1, arg2)`
用途：指数对数函数相关函数。
参数个数：2
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 整数 | 按源文档示例顺序传入 |
| 2 | `arg2` | 是 | 实数 | 按源文档示例顺序传入 |
## 精度设置及取整运算
### `int(x)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `x` | 是 | 实数 | 按源文档示例顺序传入 |
### `ceil(arg1)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
### `ceil32(arg1)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
### `ceil64(arg1)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
### `floor(arg1)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
### `floor32(arg1)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
### `floor64(arg1)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
### `trunc(arg1)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
### `trunc32(arg1)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
### `trunc64(arg1)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
### `frac(x)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `x` | 是 | 实数 | 按源文档示例顺序传入 |
### `round(x)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `x` | 是 | 实数 | 按源文档示例顺序传入 |
### `round32(arg1)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
### `round64(arg1)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
### `simpleRound(x)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `x` | 是 | 实数 | 按源文档示例顺序传入 |
### `simpleRound32(arg1)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
### `simpleRound64(arg1)`
用途：精度设置及取整运算相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
### `roundTo(arg1, arg2)`
用途：精度设置及取整运算相关函数。
参数个数：2
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
| 2 | `arg2` | 是 | 整数 | 按源文档示例顺序传入 |
### `simpleRoundTo(arg1[, arg2])`
用途：精度设置及取整运算相关函数。
参数个数：1 到 2
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
| 2 | `arg2` | 否 | 整数 | 按源文档示例顺序传入 |
## 比较判断函数
### `isNan(v)`
用途：判断条件是否成立。
参数个数：1
返回值：布尔值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `v` | 是 | 任意值 | 按源文档示例顺序传入 |
### `isInfinite(inf)`
用途：判断条件是否成立。
参数个数：1
返回值：布尔值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `inf` | 是 | 任意值 | 按源文档示例顺序传入 |
### `sign(arg1)`
用途：比较判断函数相关函数。
参数个数：1
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 整数 | 按源文档示例顺序传入 |
### `isZero(arg1, arg2)`
用途：判断条件是否成立。
参数个数：2
返回值：布尔值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 任意值 | 按源文档示例顺序传入 |
| 2 | `arg2` | 是 | 实数 | 按源文档示例顺序传入 |
### `min(arg1, arg2)`
用途：进行数值统计计算。
参数个数：2
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 整数 | 按源文档示例顺序传入 |
| 2 | `arg2` | 是 | 实数 | 按源文档示例顺序传入 |
### `max(arg1, arg2)`
用途：进行数值统计计算。
参数个数：2
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | --------- | -------------------- |
| 1 | `arg1` | 是 | 整数/数组 | 按源文档示例顺序传入 |
| 2 | `arg2` | 是 | 实数/数组 | 按源文档示例顺序传入 |
### `compareValue(arg1, arg2, arg3)`
用途：比较判断函数相关函数。
参数个数：3
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 整数 | 按源文档示例顺序传入 |
| 2 | `arg2` | 是 | 整数 | 按源文档示例顺序传入 |
| 3 | `arg3` | 是 | 实数 | 按源文档示例顺序传入 |
### `sameValue(arg1, arg2, arg3)`
用途：比较判断函数相关函数。
参数个数：3
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 整数 | 按源文档示例顺序传入 |
| 2 | `arg2` | 是 | 整数 | 按源文档示例顺序传入 |
| 3 | `arg3` | 是 | 实数 | 按源文档示例顺序传入 |
### `randomRange(arg1, arg2)`
用途：比较判断函数相关函数。
参数个数：2
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
| 2 | `arg2` | 是 | 实数 | 按源文档示例顺序传入 |
### `inRange(arg1, arg2, arg3)`
用途：比较判断函数相关函数。
参数个数：3
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
| 2 | `arg2` | 是 | 整数 | 按源文档示例顺序传入 |
| 3 | `arg3` | 是 | 整数 | 按源文档示例顺序传入 |
### `ensureRange(arg1, arg2, arg3)`
用途：比较判断函数相关函数。
参数个数：3
返回值：处理后的结果值
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1 | `arg1` | 是 | 实数 | 按源文档示例顺序传入 |
| 2 | `arg2` | 是 | 整数 | 按源文档示例顺序传入 |
| 3 | `arg3` | 是 | 整数 | 按源文档示例顺序传入 |
## 位运算函数
### `_and(left, right)`
用途：对两个整数做按位与运算。
参数个数：2
返回值：整数
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------- | ---- | -------- | -------- |
| 1 | `left` | 是 | 整数 | 左操作数 |
| 2 | `right` | 是 | 整数 | 右操作数 |
### `_or(left, right)`
用途：对两个整数做按位或运算。
参数个数：2
返回值：整数
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------- | ---- | -------- | -------- |
| 1 | `left` | 是 | 整数 | 左操作数 |
| 2 | `right` | 是 | 整数 | 右操作数 |
### `_not(value)`
用途：对整数做按位取反运算。
参数个数：1
返回值：整数
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------- | ---- | -------- | -------- |
| 1 | `value` | 是 | 整数 | 输入整数 |
### `_xor(left, right)`
用途：对两个整数做按位异或运算。
参数个数：2
返回值：整数
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------- | ---- | -------- | -------- |
| 1 | `left` | 是 | 整数 | 左操作数 |
| 2 | `right` | 是 | 整数 | 右操作数 |
### `_shl(value, bits)`
用途：将整数按位左移。
参数个数：2
返回值：整数
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------- | ---- | -------- | -------- |
| 1 | `value` | 是 | 整数 | 输入整数 |
| 2 | `bits` | 是 | 整数 | 左移位数 |
### `_shr(value, bits)`
用途：将整数按位右移。
参数个数：2
返回值：整数
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------- | ---- | -------- | -------- |
| 1 | `value` | 是 | 整数 | 输入整数 |
| 2 | `bits` | 是 | 整数 | 右移位数 |
### `_rol(value, bits)`
用途：将整数按位循环左移。
参数个数：2
返回值：整数
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------- | ---- | -------- | ------------ |
| 1 | `value` | 是 | 整数 | 输入整数 |
| 2 | `bits` | 是 | 整数 | 循环左移位数 |
### `_ror(value, bits)`
用途：将整数按位循环右移。
参数个数：2
返回值：整数
| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------- | ---- | -------- | ------------ |
| 1 | `value` | 是 | 整数 | 输入整数 |
| 2 | `bits` | 是 | 整数 | 循环右移位数 |