♻️ refactor(tsl-api-reference): reorganize function reference pages
Move runtime and document pages into their correct scope, remove obsolete pending entries, and regenerate the function index.\nUpdate agent test guidance and API skill routing to match the new reference layout.
This commit is contained in:
@@ -308,3 +308,190 @@
|
||||
返回：any
|
||||
|
||||
## 网络访问以及相关函数
|
||||
|
||||
## `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
|
||||
|
||||
## `ft_Expression2_3(l1)`
|
||||
|
||||
表达式函数教学函数。返回指定股票在指定日180个序列的L1乖离率，与系统参数(股票，周期，时间，复权相关)
|
||||
|
||||
| 参数 | 类型 | 说明 |
|
||||
| ---- | ---- | ---- |
|
||||
| `l1` | any | 整数 |
|
||||
|
||||
返回：any
|
||||
|
||||
## `ft_Expression1()`
|
||||
|
||||
表达式教学函数。返回当前股票收盘价的5个周期的平均值，与当前系统参数(股票，时间，周期)相关。
|
||||
|
||||
返回：float
|
||||
|
||||
## `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
|
||||
|
||||
## `fs_InfoId(infoid)`
|
||||
|
||||
获得基本面数据教学函数。返回截止到2002年6月30日Infoid相关基本面数据。
|
||||
|
||||
| 参数 | 类型 | 说明 |
|
||||
| -------- | ---- | ------ |
|
||||
| `infoid` | any | 基本面 |
|
||||
|
||||
返回：any
|
||||
|
||||
## `ft_Expression2_2(rdate)`
|
||||
|
||||
表达式函数教学函数。返回指定股票在报告期rdate的资产负债表,与当前系统参数(股票)相关。
|
||||
|
||||
| 参数 | 类型 | 说明 |
|
||||
| ------- | -------- | ------ |
|
||||
| `rdate` | datetime | 报告期 |
|
||||
|
||||
返回：any
|
||||
|
||||
## `loadTableEx(table_name)`
|
||||
|
||||
加载用户数据TableName，如若TableName非空，则返回TableName数据，否则返回空数组。
|
||||
|
||||
| 参数 | 类型 | 说明 |
|
||||
| ------------ | ------ | -------------------- |
|
||||
| `table_name` | string | 字符串，数据文件名称 |
|
||||
|
||||
返回：array
|
||||
|
||||
### 示例
|
||||
|
||||
```tsl
|
||||
return loadTableEx('repitle');
|
||||
// 返回: repitle为保存好的用户数据
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user