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

📦 deps(tsl): sync tsl-playbook from 49e6dadc

Browse Source 
Source-Commit: 49e6dadc60
This commit is contained in:
ci[bot]
2026-07-20 01:42:42 +00:00
parent 713671152c
commit 9fedb2cf7f
61 changed files with 27118 additions and 25747 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skills/tsl-api-reference/references/codegen/builtin/resource/file.md
+17 -204
View File
@@ -38,7 +38,7 @@ return data;
attr := rdo2 fileMode("", "c:\\test11.txt");
ret := rdo2 fileModeToStr(attr);
return ret;
// 结果：” A”
// 输出：” A”
```
## `zipCompress(zip_alias, zip_filename, alias, filename, path)`
@@ -106,106 +106,6 @@ zipExtract('', 'd:\\a.zip', '', 'd:\\tmp', '123');
rarExtract('', 'd:\\a.rar', '', 'd:\\tmp', '123');
```
## `ImportantItems_Call(stock_arr, end_t, sort_by, return_number)`
上市公司最新主要财务指标排行。
| 参数 | 类型 | 说明 |
| --------------- | -------- | ------------------------------ |
| `stock_arr` | array | 数组。股票列表。 |
| `end_t` | datetime | 整数。报告期。 |
| `sort_by` | any | 整数。排序字段，取值如下: |
| `return_number` | any | 整数。返回个数，-1时返回全部。 |
返回：array
## `fl_ImportFile(import_type, id)`
ImportFile函数教学函数。导入保存类型为importType的指定ID证券数据文件。若文件不存在则返回'file not exist'，若文件导入失败则返回'Import file fail'。其中虚拟目录名为'testdir'，用户应申请服务器权限并且建立好该虚拟目录。
| 参数 | 类型 | 说明 |
| ------------- | ------ | ---------- |
| `import_type` | any | 用户自定义 |
| `id` | string | 证券 |
返回：any
## `fl_WriteFile(b_kname, t)`
WriteFile函数教学函数。将指定板块BKname的每一只股票在指定日T的行情数据保存到虚拟目录'testdir'下的'HqData.dat'文件，写出成功则返回'convert finished'。用户应申请好服务器权限，并建立好虚拟目录'testdir'。
| 参数 | 类型 | 说明 |
| --------- | -------- | -------- |
| `b_kname` | string | 系统板块 |
| `t` | datetime | 日期 |
返回：any
## `fl_ExportFile(export_type, id, t)`
Export函数教学函数。将指定股票ID的历史报告期十大股东序列数据以exportType文件形式导出到虚拟目录'testdir'下,若导入成功则返回'export success'，否则返回'export fail!'。用户应当申请好服务器权限，并建立好虚拟目录'testdir'。
| 参数 | 类型 | 说明 |
| ------------- | ------ | ---------- |
| `export_type` | any | 用户自定义 |
| `id` | string | 证券 |
| `t` | any | 日期 |
返回：string
## `fs_InfoId(infoid)`
获得基本面数据教学函数。返回截止到2002年6月30日Infoid相关基本面数据。
| 参数 | 类型 | 说明 |
| -------- | ---- | ------ |
| `infoid` | any | 基本面 |
返回：any
## `ft_Expression2_2(rdate)`
表达式函数教学函数。返回指定股票在报告期rdate的资产负债表,与当前系统参数(股票)相关。
| 参数 | 类型 | 说明 |
| ------- | -------- | ------ |
| `rdate` | datetime | 报告期 |
返回：any
## `ft_Expression2_3(l1)`
表达式函数教学函数。返回指定股票在指定日180个序列的L1乖离率，与系统参数(股票，周期，时间，复权相关)
| 参数 | 类型 | 说明 |
| ---- | ---- | ---- |
| `l1` | any | 整数 |
返回：any
## `ft_Expression1()`
表达式教学函数。返回当前股票收盘价的5个周期的平均值，与当前系统参数(股票，时间，周期)相关。
返回：float
## `loadTableEx(table_name)`
加载用户数据TableName，如若TableName非空，则返回TableName数据，否则返回空数组。
| 参数 | 类型 | 说明 |
| ------------ | ------ | -------------------- |
| `table_name` | string | 字符串，数据文件名称 |
返回：array
### 示例
```tsl
return loadTableEx('repitle');
// 返回: repitle为保存好的用户数据
```
## `listTable()`
返回用户数据的名称列表(一维数组)。
@@ -219,93 +119,6 @@ return listTable();
// 输出：如下：
```
## `readExcelSheets(alias, file_name, sheets_name, use_ole)`
从Excel文件中读出Sheets列表。
| 参数 | 类型 | 说明 |
| ------------- | ---------- | -------------------------------------------------------------------------------- |
| `alias` | string | 字符串类型。参考目录别名。 |
| `file_name` | string | 字符串类型。文件名称。 |
| `sheets_name` | array | 返回值。存贮读出的SHEETS名称，存贮为一个一维字符串数组。 |
| `use_ole` | bool=false | 布尔型。是否使用Excel来读取，默认直接采用读文件的方式。设置为真则要求安装Excel。 |
返回：bool
### 示例
```tsl
// 读取本地文件的sheet列表名
rdo2 readExcelSheets('', 'd:\\test\\test.xls', r, 0);
return r;
// 结果：array("Sheet1","Sheet2","Sheet3")
```
## `exportFile2(_type, alias, file_name, data, include_header, include_index, sheet, range)`
将数据导出到指定Sheet、指定数据位置Range的excel文件，仅支持Type类型为ftxls()的，为了兼容其他类型，如果输入的类型是非ftxls()的，则执行exportfile导出数据且无法指定Sheet和Range。注：导出时对应的excel文件需要关闭。
| 参数 | 类型 | 说明 |
| ---------------- | ------ | ----------------------------------------------------------------- |
| `_type` | | 整数类型。参考导入导出类型函数。 |
| `alias` | string | 字符串类型。参考目录别名。 |
| `file_name` | string | 字符串类型。文件名称。 |
| `data` | | 数据，需要导出的数据。 |
| `include_header` | bool | 布尔类型。为真时导出的文件包含字段头部信息。缺省时候为真。 |
| `include_index` | bool | 布尔类型。为真时导出的文件包含数组下标信息。缺省时候为假。 |
| `sheet` | string | 字符串类型，指定Sheet。 |
| `range` | string | 字符串类型，指定单元格，如:”A1”表示要把数据导出到A1开始的单元格。 |
返回：integer|string
### 示例
```tsl
// 导出10 * 5全1矩阵，到C: \\test.xlsx 文件的Sheet3，C2单元格。
data := ones(10, 5);
ret := rdo2 exportFile2(ftXls(), "", "C:\\test.xlsx", data, 1, 0, "Sheet3", "C2");
return ret;
// 结果：1 (表示数据导出成功，可以在c盘看到test.xlsx文件)
```
## `importFile2(_type, alias, file_name, data, include_header, include_index, force_single, sheet, range)`
导入excel中指定Sheet的内容，可选择指定数据范围Range。仅支持Type类型为ftxls()的，为了兼容其他类型，如果输入的类型是非ftxls()的，则执行importfile导入数据且无法指定数据位置Range。
| 参数 | 类型 | 说明 |
| ---------------- | ------- | ------------------------------------------------------------------------------------------------ |
| `_type` | integer | 整数类型。参考导入导出类型函数。 |
| `alias` | string | 字符串类型。参考目录别名。 |
| `file_name` | string | 字符串类型。文件名称。 |
| `data` | bool | 变参返回，存贮导入的数据。当导入成功的时候，数据将存放在Data。 |
| `include_header` | bool | 布尔类型。为真时认为导入的文件包含字段头部信息。缺省时候为真。 |
| `include_index` | bool | 布尔类型。为真时认为导入的文件包含数组下标信息。缺省时候为假。 |
| `force_single` | bool | 布尔类型。为真时认为导入的文件是一个一维数组。缺省时候为假。 |
| `sheet` | string | 字符串类型，指定Sheet。 |
| `range` | string | 字符串类型，指定单元格范围，如果为空导入Sheet的所有数据，非空则必须为excel的Range，如:“A1:E13“。 |
返回：bool
### 示例
```tsl
// 导入"C:\\test.xlsx"文件中的Sheet3的"C2:E5"数据，包含字段名称。
ret := rdo2 importFile2(ftXls(), "", "C:\\test.xlsx", data, 1, 0, 0, "Sheet3", "C2:E5");
if ret then
return data;
else
return "导入失败";
// 输出：
// 无输出。
// Excel的数据：
```
## `ftCsVne()`
逗号分割文件类型，输出结果禁用1E20等类型
返回：integer
## `loadTable(name, table_type)`
提取用户数据，装入用户表，从name指定的位置将数据导出。TableType参数可省略，默认为0；0或省略时表示装入当前用户表，1表示装入系统表，即可导入系统账号system的用户数据。
@@ -337,7 +150,7 @@ return loadTable('testA');
attr := rdo2 fileAttr("", "c:\\test11.txt");
ret := rdo2 fileAttrToStr(attr);
return ret;
// 结果：”A”
// 输出：”A”
```
## `strToFileAttr(str)`
@@ -355,7 +168,7 @@ return ret;
```tsl
str1 := "A";
return rdo2 strToFileAttr(str1);
// 结果：32
// 输出：32
```
## `strToFileMode(str)`
@@ -373,7 +186,7 @@ return rdo2 strToFileAttr(str1);
```tsl
str1 := "A";
return rdo2 strToFileMode(str1);
// 结果：32
// 输出：32
```
## `ftCsv()`
@@ -493,7 +306,7 @@ return data1;
```tsl
// 客户端中本地执行
return rdo2 sysExecName();
// 返回：C: \Program Files\Tinysoft\AnalyseNG.NET\TSExpert.exe
// 输出：C: \Program Files\Tinysoft\AnalyseNG.NET\TSExpert.exe
// 本地解析器中运行
echo sysExecName();
// 打印信息：C: \Program Files\Tinysoft\AnalyseNG.NET\TSL.exe
@@ -510,7 +323,7 @@ echo sysExecName();
```tsl
// 客户端中本地执行
return rdo2 pluginPath();
// 返回：C: \Program Files\Tinysoft\AnalyseNG.NET\Plugin\
// 输出：C: \Program Files\Tinysoft\AnalyseNG.NET\Plugin\
```
## `getlogicdrive()`
@@ -545,7 +358,7 @@ return rdo2 getlogicdrive();
```tsl
path := "D:\\test\\test.txt"; // 已经存在的文件
return rdo2 createlink("D:\\test\\txt", path, 1); // 创建一个硬链接
// 结果：创建链接成功，返回1
// 输出：创建链接成功，返回1
```
范例02：创建软链接
@@ -553,7 +366,7 @@ return rdo2 createlink("D:\\test\\txt", path, 1); // 创建一个硬链接
```tsl
path := "D:\\test\\test.txt"; // 已存在的文件
return rdo2 createlink("D:\\test\\txt", path, 0); // 创建一个软链接
// 结果：链接成功，返回1
// 输出：链接成功，返回1
```
## `realpath(name)`
@@ -619,7 +432,7 @@ data := rand(10, 5);
ret := rdo2 exportFile(ftXls(), "", "c:\\test.xls", data);
if ret=1 then return "导出成功";
else return ret; // 出错
// 结果："导出成功" (表示数据导出成功，可以在c盘看到test.xls文件)
// 输出："导出成功" (表示数据导出成功，可以在c盘看到test.xls文件)
```
范例02：
@@ -742,7 +555,7 @@ bool=1
ret := rdo2 iniWriteBool("",
"C:\\Program Files\\Tinysoft\\Analyse.NET\\plugin\\test.ini", "Inidata9", "bool", 1);
return ret;
// 结果：0，写入成功
// 输出：0，写入成功
// 文件写入：
```
@@ -771,7 +584,7 @@ date=2014/1/12
ret := rdo2 iniWriteDate("",
"C:\\Program Files\\Tinysoft\\Analyse.NET\\plugin\\test.ini", "Inidata2", "date", 41651);
return ret;
// 结果：0 ，设置成功
// 输出：0 ，设置成功
// 文件修改：
```
@@ -800,7 +613,7 @@ datetime=2014/1/12 14: 00: 00
ret := rdo2 iniWriteDateTime("",
"C:\\Program Files\\Tinysoft\\Analyse.NET\\plugin\\test.ini", "Inidata3", "datetime", 41651.5833334);
return ret;
// 结果：0，修改成功
// 输出：0，修改成功
// 文件修改：
```
@@ -829,7 +642,7 @@ float=9.9
ret := rdo2 iniWriteFloat("",
"C:\\Program Files\\Tinysoft\\Analyse.NET\\plugin\\test.ini", "Inidata4", "float", 9.9);
return ret;
// 结果：0，修改成功
// 输出：0，修改成功
// 文件修改：
```
@@ -858,7 +671,7 @@ INT=100
ret := rdo2 iniWriteInteger("",
"C:\\Program Files\\Tinysoft\\Analyse.NET\\plugin\\test.ini", "Inidata5", "INT", 100);
return ret;
// 结果：0，修改成功
// 输出：0，修改成功
// 文件修改：
```
@@ -887,7 +700,7 @@ time=12: 00: 00
ret := rdo2 iniWriteTime("",
"C:\\Program Files\\Tinysoft\\Analyse.NET\\plugin\\test.ini", "Inidata6", "time", 0.5);
return ret;
// 结果：0，修改成功
// 输出：0，修改成功
// 文件修改：
```
@@ -916,7 +729,7 @@ String=Hello Tinysoft
ret := rdo2 iniWriteString("",
"C:\\Program Files\\Tinysoft\\Analyse.NET\\plugin\\test.ini", "IniData7", "String", 'Hello Tinysoft');
return ret;
// 结果：0，修改成功
// 输出：0，修改成功
// 文件修改：
```
@@ -940,5 +753,5 @@ return ret;
ret := rdo2 iniDeleteKey("",
"C:\\Program Files\\Tinysoft\\Analyse.NET\\plugin\\test.ini", "Inidata9", "bool");
return ret;
// 结果：0，删除成功
// 输出：0，删除成功
```