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

✨ feat(tsl-api-reference): update API catalog and data dictionary

Browse Source
This commit is contained in:
csh
2026-08-11 18:10:24 +08:00
parent 34a3a5dec1
commit 7bd965de89
1231 changed files with 64187 additions and 18822 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skills/tsl-api-reference/references/codegen/builtin/runtime.md
+84 -22
View File
@@ -8,6 +8,8 @@
从指定精度四舍五入截断小数点位数，返回number的保留小数点Precision位后的值
<!-- tags: 运行时 设置 修改 -->
| 参数 | 类型 | 说明 |
| ----------- | ------- | ------------------------------------------ |
| `number` | real | 实数/实数数组。 |
@@ -27,7 +29,9 @@ echo setPrecision(123.4567, 3), "\n";
声明：function
转换成为STM流数据。可以通过stmType参数控制是否转换为新流模式或超大流新流模式，新的stm流占用空间更少，访问效率更高。
转换成为STM流数据。可以通过stmType参数控制是否转换为新流模式或超大流新流模式，新的stm流占用空间更少，访问效率更高
<!-- tags: 运行时 转换 编码 STM -->
| 参数 | 类型 | 说明 |
| ---------- | ------- | ---------------------------------------------------------------------------------------------------------- |
@@ -51,7 +55,9 @@ echo toStn(stm(stream)), "\n";
声明：function
转换成为STN字符串。小数位四舍五入，尾数是五就进一。
转换成为STN字符串。小数位四舍五入，尾数是五就进一
<!-- tags: 运行时 转换 编码 STN -->
| 参数 | 类型 | 说明 |
| ---- | ------- | --------------------------------------------------------------------- |
@@ -72,7 +78,9 @@ echo toStn(1.2345, 2), "\n";
声明：function
将指定数组Data转换为csv格式字符串并存储在csvStr参数中。仅支持一维及二维数组的转换。和ExportCsvne的区别：在处理浮点数据时，ExportCsv的结果会输出为1E15等格式。
将指定数组Data转换为csv格式字符串并存储在csvStr参数中。仅支持一维及二维数组的转换。和ExportCsvne的区别：在处理浮点数据时，ExportCsv的结果会输出为1E15等格式
<!-- tags: 运行时 转换 编码 -->
| 参数 | 类型 | 说明 |
| ---------------- | ------ | ----------------------------------------------------------- |
@@ -97,7 +105,9 @@ echo ok, ":", csv_text, "\n";
声明：function
设置需要记录的优化信息（当设置了记录优化信息的时候，运行速度可能会比正常运行慢很多）并返回设置前的状态值，如果设置了记录优化信息，在平台运行的模型结束的时候会在终端打开优化信息的窗口，用户也可以调用GetProfilerInfo来手动获得优化信息。
设置需要记录的优化信息（当设置了记录优化信息的时候，运行速度可能会比正常运行慢很多）并返回设置前的状态值，如果设置了记录优化信息，在平台运行的模型结束的时候会在终端打开优化信息的窗口，用户也可以调用GetProfilerInfo来手动获得优化信息
<!-- tags: 运行时 设置 修改 -->
| 参数 | 类型 | 说明 |
| ------ | ---- | --------------------------------------------------------------------------------------------------------------------------- |
@@ -122,7 +132,9 @@ echo sum, "\n";
声明：function
返回一个随机的数组元素，这个数组是由参数Avalue传递进来的。
返回一个随机的数组元素，这个数组是由参数Avalue传递进来的
<!-- tags: 运行时 返回 获取 -->
| 参数 | 类型 | 说明 |
| --------- | ------------ | ---------------------------------- |
@@ -145,7 +157,9 @@ echo selected = 10 or selected = 20 or selected = 30, "\n";
声明：function
取出所有系统参数的值。
获取所有系统参数的值
<!-- tags: 运行时 获取 查询 -->
返回：array
@@ -161,7 +175,9 @@ echo toStn(getSysParams()), "\n";
声明：function
根据名称或者函数指针调用指定的函数，后面带的参数将自动送入该函数。
根据名称或者函数指针调用指定的函数，后面带的参数将自动送入该函数
<!-- tags: 运行时 -->
| 参数 | 类型 | 说明 |
| ----------- | ----------------- | ------------------------------------------------ |
@@ -183,7 +199,9 @@ echo call("StrToIntDef", "123", 0), "\n";
声明：function
根据名称或者函数指针调用指定的函数，将参数放入一个数组中送入该函数，不支持变参。另外，天软的函数指针可以用thisfunction()获得。该函数与call函数功能类似，注意两个函数设置参数的区别。Call函数直接列举，CallInArray函数将调用的函数的参数放在Array中。
根据名称或者函数指针调用指定的函数，将参数放入一个数组中送入该函数，不支持变参。另外，天软的函数指针可以用thisfunction()获得。该函数与call函数功能类似，注意两个函数设置参数的区别。Call函数直接列举，CallInArray函数将调用的函数的参数放在Array中
<!-- tags: 运行时 -->
| 参数 | 类型 | 说明 |
| --------------- | ----------------- | ---------------------------------------------------------------------------- |
@@ -204,7 +222,9 @@ echo callInArray("StrToIntDef", array("123", 0)), "\n";
声明：function
返回一份value的复制值，一般无需要使用，特别用于不需要变参的函数调用。
返回一份value的复制值，一般无需要使用，特别用于不需要变参的函数调用
<!-- tags: 运行时 返回 获取 -->
| 参数 | 类型 | 说明 |
| ------- | ---- | ---------------------- |
@@ -227,7 +247,9 @@ echo toStn(array(source_values, copied_values)), "\n";
声明：function
计算表达式并返回表达式的值。表达式可以引用当前作用域中的变量。
计算表达式并返回表达式的值。表达式可以引用当前作用域中的变量
<!-- tags: 运行时 计算 求解 -->
| 参数 | 类型 | 说明 |
| ----- | ----------- | ---------------- |
@@ -250,7 +272,9 @@ echo eval(@(a + b)), "\n";
声明：function
按名称调用对象成员方法或设置成员属性，支持调用重载方法。
按名称调用对象成员方法或设置成员属性，支持调用重载方法
<!-- tags: 运行时 -->
| 参数 | 类型 | 说明 |
| -------------- | --------- | -------------------------------------------- |
@@ -288,7 +312,9 @@ end;
声明：function
按名称调用对象成员方法或设置成员属性，并用数组传递属性值或方法参数。该函数支持命名参数。
按名称调用对象成员方法或设置成员属性，并用数组传递属性值或方法参数。该函数支持命名参数
<!-- tags: 运行时 -->
| 参数 | 类型 | 说明 |
| -------------- | --------- | ------------------------------------------------------------------ |
@@ -327,6 +353,8 @@ end;
如果Avalue值为真，返回参数Atrue，否则返回参数Afalse
<!-- tags: 运行时 判断 检查 -->
| 参数 | 类型 | 说明 |
| --------- | ---- | -------------------------- |
| `avalue` | bool | 布尔类型，判定条件 |
@@ -351,6 +379,8 @@ echo ifThen(a > b, a, b), "\n";
强制成整数，类型转换，对有些必需要指定类型的函数有用,如format
<!-- tags: 运行时 转换 编码 -->
| 参数 | 类型 | 说明 |
| ------- | ---- | ---------- |
| `value` | real | 实数或整数 |
@@ -371,6 +401,8 @@ echo integer(123.456), "\n";
强制成整数，类型转换，对有些必需要指定类型的函数有用,如format
<!-- tags: 运行时 转换 编码 -->
| 参数 | 类型 | 说明 |
| ------- | ---- | ---------- |
| `value` | real | 实数或整数 |
@@ -391,6 +423,8 @@ echo int64(123), "\n";
强制为实数，类型转换，对有些必需要指定类型的函数有用，如format
<!-- tags: 运行时 转换 编码 -->
| 参数 | 类型 | 说明 |
| ------- | ---- | ---------- |
| `value` | real | 实数或整数 |
@@ -409,7 +443,9 @@ echo real(123), "\n";
声明：function
将字符串转为Unicode字符串，或者强制让二进制为Unicode字符串。
将字符串转为Unicode字符串，或者强制让二进制为Unicode字符串
<!-- tags: 运行时 -->
| 参数 | 类型 | 说明 |
| ------- | -------------------------- | -------------------- |
@@ -431,6 +467,8 @@ echo wideString("Tinysoft"), "\n";
强制把字符串或者Unicode字符串转化为二进制流，对有些必需要指定类型的函数有用
<!-- tags: 运行时 -->
| 参数 | 类型 | 说明 |
| ------- | -------------------------- | -------------------- |
| `value` | string\|binary\|widestring | 字符串或者二进制数据 |
@@ -449,7 +487,9 @@ echo toStn(binary("Tinysoft")), "\n";
声明：function
把STN串转换为任意类型。
把STN串转换为任意类型
<!-- tags: 运行时 转换 编码 STN -->
| 参数 | 类型 | 说明 |
| ---- | ------ | ------------- |
@@ -470,7 +510,9 @@ echo toStn(stn(serialized)), "\n";
声明：function
已废弃函数。
已废弃函数
<!-- tags: 运行时 -->
返回：any
@@ -489,6 +531,8 @@ echo random(), "\n";
（参考文档未提供简述。）
<!-- tags: 运行时 -->
返回：real
### 示例
@@ -503,7 +547,9 @@ echo random(), "\n";
声明：function
返回从 `0` 到 `value - 1` 的随机整数。
返回从 `0` 到 `value - 1` 的随机整数
<!-- tags: 运行时 返回 获取 -->
| 参数 | 类型 | 说明 |
| ------- | ------- | ------------------------ |
@@ -522,7 +568,9 @@ echo random(1), "\n";
声明：function
获取正在执行的 `.tsl` 主脚本完整路径。
获取正在执行的 `.tsl` 主脚本完整路径
<!-- tags: 运行时 获取 查询 -->
返回：string
@@ -538,7 +586,9 @@ echo tslfilename(), "\n";
声明：function
获取当前函数库查找路径。
获取当前函数库查找路径
<!-- tags: 运行时 查找 搜索 lookup 获取 查询 -->
返回：string
@@ -556,7 +606,9 @@ echo sysgettsllibpath(), "\n";
声明：function
获得记录的优化信息。
获取记录的优化信息
<!-- tags: 运行时 获取 查询 -->
| 参数 | 类型 | 说明 |
| ------- | ---- | --------- |
@@ -582,7 +634,9 @@ echo length(profiler_info), "\n";
声明：function
将指定csv格式字符串csvStr转换为数组，并存储在Data参数中。
将指定csv格式字符串csvStr转换为数组，并存储在Data参数中
<!-- tags: 运行时 -->
| 参数 | 类型 | 说明 |
| ---------------- | ------ | --------------------------------------------------------------- |
@@ -608,7 +662,9 @@ echo ok, ":", toStn(data), "\n";
声明：function
把STM流转换为任意类型。
把STM流转换为任意类型
<!-- tags: 运行时 转换 编码 STM -->
| 参数 | 类型 | 说明 |
| ---- | ------ | ----------------- |
@@ -631,6 +687,8 @@ echo toStn(stm(stream)), "\n";
将当前变量递交到客户端调试窗口
<!-- tags: 运行时 -->
| 参数 | 类型 | 说明 |
| ----------- | ------- | -------------------- |
| `sys_param` | boolean | 是否同时输出系统参数 |
@@ -651,7 +709,9 @@ echo result;
声明：function
估算变量占用的内存空间
获取估算变量占用的内存空间
<!-- tags: 运行时 获取 查询 -->
| 参数 | 类型 | 说明 |
| ------- | ---- | ------------ |
@@ -675,6 +735,8 @@ echo getEstSize(value) >= 0;
返回指定计时点或最近一次 `mTic` 之后经过的秒数
<!-- tags: 运行时 返回 获取 -->
| 参数 | 类型 | 说明 |
| ------ | ---- | ------------------------------------------------------- |
| `tick` | real | 可选。由 `mTic` 返回的计时点，省略时使用最近一次 `mTic` |