♻️ refactor(tsl): rebuild codegen taxonomy

Move generated builtin and dotnet function docs into the upgraded taxonomy, remove legacy route pages, and regenerate function_index.tsv from markdown headings.
2026-07-07 16:36:08 +08:00
parent 54c1c11e77
commit b6160676b4
763 changed files with 179921 additions and 154583 deletions
@@ -0,0 +1,233 @@
+# Builtin - 外部交互 / CGI
+
+## `unsetEchoString()`
+
+取出被SetEchoString后的重定向输出流，取出后重置输出流为空。
+
+返回：string
+
+## `isEchoRedirect()`
+
+判断目前是否被SetEchoString重定向，如果被重定向了，返回为真，否则为假。
+
+返回：bool
+
+## `readLn()`
+
+从控制台读字符串并返回结果（输入以回车结束）。
+
+返回：string
+
+## `writeln(p1, pn)`
+
+带回车地输出字符串，如果在平台运行，会输出信息到客户端。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `p1` | string | string 字符串1 |
+| `pn` | string | string 字符串n |
+
+返回：any
+
+### 示例
+
+```tsl
+// 先输出111222，接着另起一行显示空白，再接着另起一行输出333
+writeln("111", "222");
+writeln("333");
+{结果页面中，运行信息下打印：
+111222
+333
+}
+```
+
+## `write(p1, pn)`
+
+输出字符串，如果在平台运行，会输出信息到客户端。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `p1` | string | string 字符串1 |
+| `pn` | string | string 字符串n |
+
+返回：any
+
+### 示例
+
+```tsl
+// 先输出123456，接着另起一行输出789
+write("123", "456");
+write("789");
+return;
+{在结果页面中打印：
+123456
+789}
+```
+
+## `httpGetContent()`
+
+返回前端发送的内容串，如果内容串长度和HttpGetContentLength不一致，则需要用TWebRequest类来读取剩余内容。
+
+返回：string
+
+## `httpGetContentLength()`
+
+返回前端发送的内容串的长度。
+
+返回：integer
+
+## `httpGetQueryString()`
+
+返回前端发送的查询串。
+
+返回：string
+
+### 示例
+
+```tsl
+// 前端执行的是http: // hostname/test.tsl?name=billgates&sex=male，
+// 则返回的值为name=billgates&sex=male
+```
+
+## `httpGetRequestMethod()`
+
+返回前端发送请求的类型。如get或者put。
+
+返回：string
+
+## `httpGetQueryValues()`
+
+分解前端发送的查询串为字符串下标的字符串数组。
+
+返回：array[key:string] of string
+
+## `httpGetQueryValueByName(name, additional_info)`
+
+得到指定参数的查询串的值。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `name` | string | 字符串类型。查询串中的变量名。 |
+| `additional_info` | string | 字符串类型，返回附加信息。最常见的是当查询的Name为文件上传的ID时，函数返回文件的内容，而AdditionalInfo返回包括文件名等内容的附加信息。 |
+
+返回：string
+
+## `httpGetQueryValueByNameEx(name)`
+
+得到查询串的值，网页多文件一次性上传可能会用多同名多个内容的情况，返回二维数组结构。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `name` | string | 字符串，查询串中的变量名。 |
+
+返回：array
+
+## `httpGetScriptName()`
+
+返回所执行的CGI名。
+
+返回：string
+
+## `httpGetPathInfo()`
+
+返回所执行的CGI的虚拟路径名。
+
+返回：string
+
+## `httpGetPathTranslated()`
+
+返回所执行的CGI的实路径名。
+
+返回：string
+
+## `httpGetRemoteHost()`
+
+返回所执行的CGI的前端主机名。
+
+返回：string
+
+## `httpGetRemoteAddr()`
+
+返回所执行的CGI的前端IP地址。
+
+返回：string
+
+## `httpGetRemoteUser()`
+
+返回所执行的CGI的远端登录用户名。
+
+返回：string
+
+## `httpGetRemoteIdent()`
+
+返回所执行的CGI的远端识别串。
+
+返回：string
+
+## `httpGetHttpAccept()`
+
+返回接受的类型种类。
+
+返回：string
+
+## `httpGetHttpUserAgent()`
+
+返回用户代理串。
+
+返回：string
+
+## `httpGetServerName()`
+
+返回服务器名。
+
+返回：string
+
+## `httpGetServerPort()`
+
+返回服务器端口。
+
+返回：string
+
+## `httpGetServerProtocol()`
+
+返回服务器协议类别。
+
+返回：string
+
+## `httpGetServerSoftware()`
+
+返回服务器软件的名称。
+
+返回：string
+
+## `httpGetGatewayInterface()`
+
+返回网关接口。
+
+返回：string
+
+## `httpGetCookie()`
+
+返回Cookie串。
+
+返回：string
+
+## `httpGetEnvVar(env_name)`
+
+返回指定名称的环境串。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `env_name` | string | 字符串类型，环境变量名。 |
+
+返回：string
+
+## `httpSetHeadString(header)`
+
+设置返回的HTTP头。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `header` | string | 字符串类型，Http头，以连续两个回车换行作为结尾。 |
+
+返回：string
@@ -0,0 +1,406 @@
+# Builtin - 外部交互 / COM
+
+## `cverrget(v)`
+
+获取NAN数据的错误号，出来的结果仅应使用低32位，也就是需要用 .& 0xFFFFFFFF，因为高字的数据是无法确定的。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `v` | double | |
+
+返回：int64
+
+## `cverr(v)`
+
+将错误号转为包含错误号的特殊的NAN数据。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `v` | int64 | |
+
+返回：real
+
+### 示例
+
+```tsl
+return cverr(0x800A07E7); // 返回结果NAN
+```
+
+## `coInitialize()`
+
+Ole初始化。
+
+返回：any
+
+## `coUnInitialize()`
+
+Ole结束。
+
+返回：any
+
+## `pyPutVar(var_name, var_value)`
+
+送入python变量
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `var_name` | string | |
+| `var_value` | any | |
+
+返回：integer
+
+## `pyGetVar(var_name)`
+
+从python 获得变量
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `var_name` | string | |
+
+返回：any
+
+## `pyRun(python_code, flag)`
+
+简单运行Python的代码
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `python_code` | string | 字符串类型，Python代码串，可执行多行代码。注意，使用空格对齐来确定逻辑层级，相同空格数代表同一层级，一般推荐使用4个空格。 |
+| `flag` | integer | 整型，可选参数，默认不被指定，该含义由PyCompileFlags指定组合的状态，处理UTF-8源代码等问题。具体请参考Python手册。 |
+
+返回：integer
+
+### 示例
+
+```tsl
+s := "a=1
+b=1
+if a==1:
+b=2
+";
+pyRun(s);
+return array("a": pyGetVar("a"), "b": pyGetVar("b"));
+// 本地执行返回结果：
+```
+
+## `pyCall(call_flag)`
+
+调用python 模块中的函数
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `call_flag` | integer | 结果输出方式与参数输入方式的设置，是一个按位（2位二进制）的状态组合值，即取值为二进制的00,01,10,11组合，具体含义如下: |
+
+返回：any
+
+### 示例
+
+```tsl
+rdo2 pyRun("import numpy");
+// 不给状态值，默认方式下调用python的randint函数
+return rdo2 pyCall('numpy.random', 'randint', 6, 9);
+// 参数通过数组方式传入
+return pyCall(2, 'numpy.random', 'randint', array('high': 9, 'low': 6));
+// 一个个指定参数方式传入
+return pyCall('numpy.random', 'randint', high: 9, low: 6);
+```
+
+## `pyRelease()`
+
+释放python资源,多线程的时候可以提高效率
+
+返回：bool
+
+## `pyEnsure()`
+
+锁定python资源;由于pyrun和pyPutVar,pyGetVar会智能锁定，所以用户一般来说不需要调用该函数。
+
+返回：bool
+
+## `pyError()`
+
+获取当前运行 Python 语句时的报错信息
+
+返回：string
+
+### 示例
+
+```tsl
+// 本地执行以下脚本
+pyRun("a=math.pi"); // 此处会报错因为没有 import math
+return pyError();
+// 返回： name 'math' is not defined
+```
+
+## `rEval(eval_string, code)`
+
+执行R的字符串。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `eval_string` | string | 执行的串，例如”a=b+1”。 |
+| `code` | integer | 返回是否成功，为0表示成功过，否则为错误码 |
+
+返回：any
+
+## `rGetVar(var_name)`
+
+获得一个R的变量的值。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `var_name` | string | 设置的变量名，例如”a”。 |
+
+返回：any
+
+## `rPutVar(var_name, value)`
+
+设置一个R的变量的值。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `var_name` | string | 设置的变量名，例如”a”。 |
+| `value` | any | 设置的变量的值 |
+
+返回：any
+
+## `rEnsure()`
+
+锁定R资源;由于REval和RPutVar,RGetVar会智能锁定，所以用户一般来说不需要调用该函数。
+
+返回：bool
+
+## `rRelease()`
+
+释放R资源,多线程的时候可以提高效率
+
+返回：bool
+
+## `mEval(eval_string)`
+
+执行MatLab的字符串。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `eval_string` | string | 执行的串，例如”a=b+1”。 |
+
+返回：integer
+
+## `mPutVar(var_name, value)`
+
+设置一个MATLAB的变量的值。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `var_name` | string | 设置的变量名，例如”a”。 |
+| `value` | any | 设置的变量的值 |
+
+返回：integer
+
+## `mGetVar(var_name)`
+
+获得一个MATLAB的变量的值。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `var_name` | string | 要获得变量名，例如”a”。 |
+
+返回：any
+
+## `mGetBuf()`
+
+返回MATLAB引擎的警告或者错误信息。
+
+返回：string
+
+## `mClose()`
+
+关闭MATLAB引擎。
+
+返回：any
+
+## `mSetVisible(visible)`
+
+设置MATLAB引擎是否可视。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `visible` | bool | 如果为真，则显示，为假则隐藏。 |
+
+返回：integer
+
+## `stock()`
+
+字符串类型，当前证券代码系统参数，读写。
+
+返回：any
+
+## `cycle()`
+
+字符串类型，当前周期系统参数，读写。
+
+返回：any
+
+## `rate()`
+
+整数类型，当前复权类型系统参数，读写。
+
+返回：any
+
+## `rateDay()`
+
+日期类型，复权基准日系统参数，读写。
+
+返回：any
+
+## `precision()`
+
+整数类型，保留小数位数系统参数，读写。
+
+返回：any
+
+## `bk()`
+
+字符串类型，默认板块系统参数，读写。
+
+返回：any
+
+## `stocks()`
+
+股票组参数，如果调用REMOTECALLFUNC需要一次性调用多个股票进行返回，则设置该参数为数组，取消则设置Stock属性。主要用于EXCEL的表格提取数据。
+
+返回：any
+
+## `times()`
+
+时间组参数，如果调用REMOTECALLFUNC需要一次性调用多个时间进行返回，则设置该参数为数组，取消则设置Time属性。主要用于EXCEL的表格提取数据。
+
+返回：any
+
+## `bks()`
+
+板块组参数，如果调用REMOTECALLFUNC需要一次性调用多个板块进行返回，则设置该参数为数组，取消则设置BK属性。主要用于EXCEL的表格提取数据。
+
+返回：any
+
+## `nilTrans()`
+
+设置TSL语言的NIL和COM转换的规则。
+
+返回：any
+
+## `i64Trans()`
+
+设置TSL语言的Int64和COM转换的规则。
+
+返回：any
+
+## `keepRawData()`
+
+由于在EXCEL单元格中以及MATLAB中送入数据的时候，均为二维数据，但TSL很多函数的参数需要一维的参数，因此需要有一个转换的原则。数据转换规则如下：
+
+返回：any
+
+## `standardArray()`
+
+TSL返回的数组是一种array of olevariant结构，允许混合数据类型，可以将字符串，整数浮点混合在一个数组中，这样在某些其他系统中，会存在处理上的难度，为了兼容这些系统，允许指定返回的结果集为一个标准的数组。当使用这个设置的时候，必需保障返回的数据结果集是规范的类型一致的结果集，否则可能会出现错误。可设置的值定义为：
+
+返回：any
+
+## `textResult()`
+
+某些系统无法处理复杂的结果集，在这种情况下，可以使用文本来返回的结果集，文本格式是TSL可解析的数据结构文本串。设置为1则任意类型均以文本串的模式返回。
+
+返回：any
+
+## `resultFileName()`
+
+某些系统无法处理COM返回的复杂的结果集，在这种情况下，可以指定一个文件来返回结果集，调用完成后再由该系统从文件中读取数据。设置该文件名为非空的串则打开该模式，如果文件名以.csv或.xml结尾，会以CSV或XML（XML为TSL语言的标准XML格式）格式写入文件，否则，会写入EXCEL格式结构的文件。
+
+返回：any
+
+## `computebitsoption()`
+
+计算的位数选项。0：自动选择，1:32位服务器计算，2:64位服务器计算。
+
+返回：any
+
+## `computeservice()`
+
+计算的服务群组选择。空字符串为默认，’auto’为自动选择，否则为指定的服务群组名。
+
+返回：any
+
+## `remoteCallFunc(func_name, params)`
+
+利用平台执行一个函数。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `func_name` | widestring | 字符串类型，需要调用的函数名。 |
+| `params` | olevariant | Array of Variant的数组类型。用于存贮调用函数的参数。 |
+
+返回：any
+
+## `localCallFunc(func_name, params)`
+
+利用本地解释器执行一个函数。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `func_name` | widestring | 字符串类型，需要调用的函数名。 |
+| `params` | olevariant | Array of Variant的数组类型。用于存贮调用函数的参数。 |
+
+返回：any
+
+## `remoteExecute(execute_str)`
+
+利用平台执行一段TSL脚本。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `execute_str` | widestring | 字符串类型，需要执行的脚本串。 |
+
+返回：any
+
+## `localExecute(execute_str)`
+
+利用本地解释器执行一段TSL脚本。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `execute_str` | widestring | 字符串类型，需要执行的脚本串。 |
+
+返回：any
+
+## `resetSysParam()`
+
+重置系统参数。时间设置为当前时间，证券为上证指数，周期为日线，设置为不复权，复权基准日为0，返回保留小数点位数为4，股票列表为空，时间列表为空。
+
+返回：any
+
+## `adminCommand(command, time_out, recv_string, broad_string, err_msg)`
+
+提交管理员命令。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `command` | widestring | 字符串类型，提交的管理员命令串。 |
+| `time_out` | integer | 整数类型，命令超时的毫秒数。 |
+| `recv_string` | | 返回的命令结果串。 |
+| `broad_string` | | 返回的广播消息串。 |
+| `err_msg` | | 如果发生错误，返回的错误信息。 |
+
+返回：olevariant
+
+## `simplyAdminCommand(command, time_out, no_data_time_out)`
+
+提交管理员命令。
+
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `command` | widestring | 字符串类型，提交的管理员命令串。 |
+| `time_out` | integer | 整数类型，命令超时的毫秒数。 |
+| `no_data_time_out` | integer | 整数类型，收到第一个数据开始多久没有数据则返回。 |
+
+返回：olevariant