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

📝 docs(tsl): sync api skill with corrected codegen

Browse Source 
Mirror docs/tsl/codegen into the bundled tsl-api-reference skill and rebuild the function index.

Remove invalid duplicate API entries for cb_delistedbydate, createhttpsession, exportJsonString, and Anova_Bartlett so exact lookup returns the canonical entries.
This commit is contained in:
csh
2026-07-07 16:47:03 +08:00
parent bbf6977f57
commit c0bf0358e0
278 changed files with 45212 additions and 35782 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skills/tsl-api-reference/references/codegen/builtin/system/runtime.md
+128 -128
View File
@@ -6,9 +6,9 @@
从指定精度四舍五入截断小数点位数，返回number的保留小数点Precision位后的值
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `number` | real | 实数/实数数组。 |
| 参数 | 类型 | 说明 |
| ----------- | ------- | ------------------------------------------ |
| `number` | real | 实数/实数数组。 |
| `precision` | integer | 整数，目的是为了截取实数后面小数点的位数。 |
返回：real
@@ -23,12 +23,12 @@ return setPrecision(123.4567, 3); // 返回值为保留3位小数点后的实数
转换成为STM流数据。可以通过stmType参数控制是否转换为新流模式或超大流新流模式，新的stm流占用空间更少，访问效率更高。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `v` | | 任意类型数据 |
| `gtype` | integer | 可选参数，图型等特殊类型 ，默认为0 |
| 参数 | 类型 | 说明 |
| ---------- | ------- | -------------------------------------------------------------------------------------------------------------- |
| `v` | | 任意类型数据 |
| `gtype` | integer | 可选参数，图型等特殊类型 ，默认为0 |
| `stm_type` | integer | 可选参数，流模式，0：普通模式；1：新流模式；2：超极大流的紧缩模式；默认为0。其中，超大流模式能处理超大结果集。 |
| `p_n` | integer | 可选参数，精度，默认为-1，全精度 |
| `p_n` | integer | 可选参数，精度，默认为-1，全精度 |
返回：binary
@@ -47,10 +47,10 @@ return stm(s);
转换成为STN字符串。小数位四舍五入，尾数是五就进一。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `v` | any | 任意类型数据 |
| `n` | integer | 整型，保留小数点后的位数，可选参数。只对v是小数时且v的小数数位比N大有效。 |
| 参数 | 类型 | 说明 |
| ---- | ------- | ------------------------------------------------------------------------- |
| `v` | any | 任意类型数据 |
| `n` | integer | 整型，保留小数点后的位数，可选参数。只对v是小数时且v的小数数位比N大有效。 |
返回：string
@@ -72,12 +72,12 @@ return toStn(1.2345, 2); // 返回值为字符串：’1.23’。
将指定数组Data转换为csv格式字符串并存储在csvStr参数中。仅支持一维及二维数组的转换。和ExportCsvne的区别：在处理浮点数据时，ExportCsv的结果会输出为1E15等格式。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `data` | array | 数组类型，要转换成csv格式字符串的数组。 |
| `csv_str` | string | 字符串类型，转换成功的csv格式字符串（输出值）。 |
| `include_index` | bool | 可选参数，布尔类型。转换结果是否包含数组下标信息。默认为False。 |
| `include_header` | bool | 可选参数，布尔类型。转换结果是否包含字段头部信息。默认为True。 |
| 参数 | 类型 | 说明 |
| ---------------- | ------ | --------------------------------------------------------------- |
| `data` | array | 数组类型，要转换成csv格式字符串的数组。 |
| `csv_str` | string | 字符串类型，转换成功的csv格式字符串（输出值）。 |
| `include_index` | bool | 可选参数，布尔类型。转换结果是否包含数组下标信息。默认为False。 |
| `include_header` | bool | 可选参数，布尔类型。转换结果是否包含字段头部信息。默认为True。 |
返回：bool
@@ -131,9 +131,9 @@ else return ret;
设置需要记录的优化信息（当设置了记录优化信息的时候，运行速度可能会比正常运行慢很多）并返回设置前的状态值，如果设置了记录优化信息，在平台运行的模型结束的时候会在终端打开优化信息的窗口，用户也可以调用GetProfilerInfo来手动获得优化信息。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `flag` | | 整数，可省略，若省略则仅返回状态值而不设置。设置需要记录的优化信息，由一个四位二进制数组成，即以下几种常见组合说明: 取值 说明 |
| 参数 | 类型 | 说明 |
| ------ | ---- | ----------------------------------------------------------------------------------------------------------------------------- |
| `flag` | | 整数，可省略，若省略则仅返回状态值而不设置。设置需要记录的优化信息，由一个四位二进制数组成，即以下几种常见组合说明: 取值 说明 |
返回：integer
@@ -170,8 +170,8 @@ return 1;
返回一个随机的数组元素，这个数组是由参数Avalue传递进来的。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| 参数 | 类型 | 说明 |
| --------- | ------------ | ---------------------------------- |
| `avalues` | array of any | 数组名称，可以是整数数组或实数数组 |
返回：any
@@ -190,62 +190,62 @@ return randomFrom(a);
返回：array
### `loggerDebug(msg)`
### `Logger_debug(msg)`
打印带执行节点的调试信息
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| 参数 | 类型 | 说明 |
| ----- | ------ | ----------------------------------------------------------- |
| `msg` | string | 任意数据类型，如果是字符串原样打印，如果非字符串按tostn打印 |
返回：any
### `loggerInfo(msg)`
### `logger_info(msg)`
打印带执行节点的提示信息
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| 参数 | 类型 | 说明 |
| ----- | ------ | ----------------------------------------------------------- |
| `msg` | string | 任意数据类型，如果是字符串原样打印，如果非字符串按tostn打印 |
返回：any
### `loggerWarning(msg)`
### `logger_warning(msg)`
打印带执行节点的调试信息
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `msg` | any | 任意数据类型，如果是字符串原样打印，如果非字符串按tostn打印 |
| 参数 | 类型 | 说明 |
| ----- | ---- | ----------------------------------------------------------- |
| `msg` | any | 任意数据类型，如果是字符串原样打印，如果非字符串按tostn打印 |
返回：any
### `loggerInfo2(p1, p2, p3, pn)`
### `logger_info2(p1, p2, p3, pn)`
打印带执行节点的提示信息
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `p1` | any | 第一个参数的内容 |
| `p2` | any | 第二个参数的内容，可省略 |
| `p3` | any | 第三个参数的内容，可省略 |
| `pn` | any | 第N个参数的内容，可省略 |
| 参数 | 类型 | 说明 |
| ---- | ---- | ------------------------ |
| `p1` | any | 第一个参数的内容 |
| `p2` | any | 第二个参数的内容，可省略 |
| `p3` | any | 第三个参数的内容，可省略 |
| `pn` | any | 第N个参数的内容，可省略 |
返回：any
### `spUserSysParam2()`
### `sp_UserSysParam2()`
用户自定义函数教学范例，获得当前系统参数
返回：string
### `spSetSysParam1()`
### `sp_SetSysParam1()`
设置系统参数教学范例，使用缺省系统参数,返回股票.基本信息
返回：any
### `spSetSysParam2()`
### `sp_SetSysParam2()`
设置系统参数教学范例，指定系统参数(当前为SH600718),返回股票.基本信息
@@ -255,13 +255,13 @@ return randomFrom(a);
比较left与Right大小，若Left大，则返回r1;若相等，返回r2;若Right大，返回r3。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `left` | real | 实数 |
| `right` | real | 实数 |
| `r1` | expr | 表达式 |
| `r2` | expr | 表达式 |
| `r3` | expr | 表达式 |
| 参数 | 类型 | 说明 |
| ------- | ---- | ------ |
| `left` | real | 实数 |
| `right` | real | 实数 |
| `r1` | expr | 表达式 |
| `r2` | expr | 表达式 |
| `r3` | expr | 表达式 |
返回：expr
@@ -276,8 +276,8 @@ return ifThen3(1, 2, '左大', '相等', '右大');
表达式求值
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| 参数 | 类型 | 说明 |
| ----- | ----------- | ---------- |
| `exp` | texpression | 表达式类型 |
返回：any
@@ -299,11 +299,11 @@ return tsAppServerName();
根据名称或者函数指针调用指定的函数，后面带的参数将自动送入该函数。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| 参数 | 类型 | 说明 |
| ----------- | ----------------- | ------------------------------------------------ |
| `func_name` | string\|tfunction | 如果是字符串，表示函数的名称，也可以是函数类型。 |
| `p1` | any | 整数，参数1 |
| `pn` | any | 整数，参数N。 |
| `p1` | any | 整数，参数1 |
| `pn` | any | 整数，参数N。 |
返回：any
@@ -323,9 +323,9 @@ return call(f, 20140101);
转换成为XML字符串。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `v` | any | 任意类型 |
| 参数 | 类型 | 说明 |
| ---- | ---- | -------- |
| `v` | any | 任意类型 |
返回：string
@@ -344,9 +344,9 @@ return toXml('this is XML document');
把XML串转换为任意类型。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `v` | string | 字符串，XML串 |
| 参数 | 类型 | 说明 |
| ---- | ------ | ------------- |
| `v` | string | 字符串，XML串 |
返回：any
@@ -364,12 +364,12 @@ return xml('<?xml version="1.0" encoding="GB2312"?>
将指定数组Data转换为csv格式字符串并存储在csvStr参数中。仅支持一维及二维数组的转换。和ExportCsv的区别：在处理浮点数据时，ExportCsvne的结果不会输出为1E15等格式。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `data` | array | |
| `csv_str` | string | |
| `include_index` | | |
| `include_header` | bool | |
| 参数 | 类型 | 说明 |
| ---------------- | ------ | ---- |
| `data` | array | |
| `csv_str` | string | |
| `include_index` | | |
| `include_header` | bool | |
返回：bool
@@ -423,10 +423,10 @@ else return ret;
根据名称或者函数指针调用指定的函数，将参数放入一个数组中送入该函数，不支持变参。另外，天软的函数指针可以用thisfunction()获得。该函数与call函数功能类似，注意两个函数设置参数的区别。Call函数直接列举，CallInArray函数将调用的函数的参数放在Array中。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `func_name` | string\|tfunction | 如果是字符串，表示函数名称，也可以是函数类型。 |
| `param_content` | array | 数组类型，第一个参数放在ParamContent[0]，第二个放在ParamContent[1]以此类推。 |
| 参数 | 类型 | 说明 |
| --------------- | ----------------- | ---------------------------------------------------------------------------- |
| `func_name` | string\|tfunction | 如果是字符串，表示函数名称，也可以是函数类型。 |
| `param_content` | array | 数组类型，第一个参数放在ParamContent[0]，第二个放在ParamContent[1]以此类推。 |
返回：any
@@ -483,12 +483,12 @@ return callInArray("CCC", array("b": 1, "d": 4));
计算指定系统参数，指定时间序列下的指标表达式的值
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `arr` | integer | 二维数组，设置的系统参数的值 |
| `sys_name` | integer | 字符串，指定的系统参数名 |
| `time_arr` | integer | 二维数组，需要计算的指定时间 |
| `exp` | texpression | 表达式，指标表达式 |
| 参数 | 类型 | 说明 |
| ---------- | ----------- | ---------------------------- |
| `arr` | integer | 二维数组，设置的系统参数的值 |
| `sys_name` | integer | 字符串，指定的系统参数名 |
| `time_arr` | integer | 二维数组，需要计算的指定时间 |
| `exp` | texpression | 表达式，指标表达式 |
返回：array
@@ -505,8 +505,8 @@ return doubleVariableExecute(stocks, pn_Stock(), timer, @close());
表达式求值
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| 参数 | 类型 | 说明 |
| ----- | ----------- | ------ |
| `exp` | texpression | 表达式 |
返回：array
@@ -515,11 +515,11 @@ return doubleVariableExecute(stocks, pn_Stock(), timer, @close());
设置系统变量SysName的值为Arr中的元素，执行表达式exp，将表达式的值放到数组Arr中。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `arr` | array | 数组， |
| `sys_name` | string | 字符串，指定系统参数名称 |
| `exp` | texpression | 表达式 |
| 参数 | 类型 | 说明 |
| ---------- | ----------- | ------------------------ |
| `arr` | array | 数组， |
| `sys_name` | string | 字符串，指定系统参数名称 |
| `exp` | texpression | 表达式 |
返回：array
@@ -535,10 +535,10 @@ return singleVariableExecute(arr, pn_stock(), @close());
设置系统参数。主要是将value的值转化为正确的对应于systype数据类型，再通过setsysparam进行设置setysparam(systype,value)，保证系统参数设置成功。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `systype` | string | 字符串，系统参数名称 |
| `value` | real | 实数或字符串，系统参数值 |
| 参数 | 类型 | 说明 |
| --------- | ------ | ------------------------ |
| `systype` | string | 字符串，系统参数名称 |
| `value` | real | 实数或字符串，系统参数值 |
返回：integer
@@ -560,9 +560,9 @@ return tsAppServer();
返回一份value的复制值，一般无需要使用，特别用于不需要变参的函数调用。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `value` | any | 任意类型，被复制的数据 |
| 参数 | 类型 | 说明 |
| ------- | ---- | ---------------------- |
| `value` | any | 任意类型，被复制的数据 |
返回：any
@@ -593,11 +593,11 @@ end;
如果Avalue值为真，返回参数Atrue，否则返回参数Afalse
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `avalue` | bool | 布尔类型，判定条件 |
| `atrue` | any | 任意类型，Avalue为真返回值 |
| `a_false` | any | 任意类型，Avalue为假返回值 |
| 参数 | 类型 | 说明 |
| --------- | ---- | -------------------------- |
| `avalue` | bool | 布尔类型，判定条件 |
| `atrue` | any | 任意类型，Avalue为真返回值 |
| `a_false` | any | 任意类型，Avalue为假返回值 |
返回：any
@@ -614,8 +614,8 @@ return ifThen(a>b, a, b);
强制成整数，类型转换，对有些必需要指定类型的函数有用,如format
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| 参数 | 类型 | 说明 |
| ------- | ---- | ---------- |
| `value` | real | 实数或整数 |
返回：integer
@@ -630,8 +630,8 @@ return integer(123.456); // 返回值为整型数据：123。
强制成整数，类型转换，对有些必需要指定类型的函数有用,如format
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| 参数 | 类型 | 说明 |
| ------- | ---- | ---------- |
| `value` | real | 实数或整数 |
返回：int64
@@ -646,8 +646,8 @@ return int64(123); // 返回值为64位整型数据：123。
强制为实数，类型转换，对有些必需要指定类型的函数有用，如format
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| 参数 | 类型 | 说明 |
| ------- | ---- | ---------- |
| `value` | real | 实数或整数 |
返回：real
@@ -662,8 +662,8 @@ return real(123); // 返回值为实数数据：123.00
将字符串转为Unicode字符串，或者强制让二进制为Unicode字符串。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| 参数 | 类型 | 说明 |
| ------- | -------------------------- | -------------------- |
| `value` | string\|binary\|widestring | 字符串或者二进制数据 |
返回：widestring
@@ -679,8 +679,8 @@ return wideString('abcd');
强制把字符串或者Unicode字符串转化为二进制流，对有些必需要指定类型的函数有用
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| 参数 | 类型 | 说明 |
| ------- | -------------------------- | -------------------- |
| `value` | string\|binary\|widestring | 字符串或者二进制数据 |
返回：binary
@@ -695,9 +695,9 @@ return binary('111111'); // 返回值为二进制流。
把STN串转换为任意类型。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `v` | string | 字符串，STN串 |
| 参数 | 类型 | 说明 |
| ---- | ------ | ------------- |
| `v` | string | 字符串，STN串 |
返回：any
@@ -731,8 +731,8 @@ return binary('111111'); // 返回值为二进制流。
断言。若Check为假，返回出错信息
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| 参数 | 类型 | 说明 |
| ------- | ------ | ---------- |
| `error` | string | 字符串类型 |
返回：string
@@ -749,8 +749,8 @@ return assert(0, '无效的语段');
获得记录的优化信息。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| 参数 | 类型 | 说明 |
| ------- | ---- | --------- |
| `clear` | bool | Boolean。 |
返回：array
@@ -803,13 +803,13 @@ return b;
将指定csv格式字符串csvStr转换为数组，并存储在Data参数中。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `csv_str` | string | 字符串类型，csv格式字符串。 |
| `data` | array | 数组类型，转换成功的数组（输出值）。 |
| `include_index` | bool | 可选参数，布尔类型。指定字符串中是否包含数组下标信息。默认为False。 |
| `include_header` | bool | 可选参数，布尔类型。指定字符串中是否包含字段头部信息。默认为True。 |
| `single_arr` | bool | 可选参数，布尔类型。是否转换为一个一维数组。默认为False。 |
| 参数 | 类型 | 说明 |
| ---------------- | ------ | ------------------------------------------------------------------- |
| `csv_str` | string | 字符串类型，csv格式字符串。 |
| `data` | array | 数组类型，转换成功的数组（输出值）。 |
| `include_index` | bool | 可选参数，布尔类型。指定字符串中是否包含数组下标信息。默认为False。 |
| `include_header` | bool | 可选参数，布尔类型。指定字符串中是否包含字段头部信息。默认为True。 |
| `single_arr` | bool | 可选参数，布尔类型。是否转换为一个一维数组。默认为False。 |
返回：bool
@@ -845,9 +845,9 @@ else return ret;
把STM流转换为任意类型。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `v` | binary | 二进制类型，STM流 |
| 参数 | 类型 | 说明 |
| ---- | ------ | ----------------- |
| `v` | binary | 二进制类型，STM流 |
返回：any
@@ -855,9 +855,9 @@ else return ret;
按键读取全局缓存。
| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `name` | string | 缓存键 |
| `out_value` | any | 输出变量，接收缓存值 |
| 参数 | 类型 | 说明 |
| ----------- | ------ | -------------------- |
| `name` | string | 缓存键 |
| `out_value` | any | 输出变量，接收缓存值 |
返回：any