playbook/skills/tsl-api-reference/references/codegen/dotnet/runtime/file_dir.md

运行时 / 文件与目录

createDir(alias, dir_name)

创建目录。如果本地不存在该目录，可创建目录；如果该目录已存在，则创建失败，返回0。

参数	类型	说明
alias	string	字符串类型。参考目录别名。
dir_name	string	字符串类型。创建的目录名。

返回：bool

exportFile(filename, arg2, arg3, data)

文件访问函数相关函数。

参数	类型	说明
filename	int
arg2	string
arg3	string
data	array

返回：string

fileAge(alias, file_name)

取得文件的时间。

参数	类型	说明
alias	string	字符串类型。参考目录别名。
file_name	string	字符串类型。文件名称。

返回：int

fileAttr(alias, file_name)

取得文件的属性。该值是各种属性的和，可以参考WINDOWS API。 值 说明 32(0x20) 备份文件 2048(0x800) 压缩文件 64(0x40) 系统保留属性 16(0x10) 目录 16384 (0x4000) 加密文件或目录 2 (0x2) 隐藏的文件或目录 32768 (0x8000) 文件完整性 128 (0x80) 常规文件 8192 (0x2000) 非索引文件 131072 (0x20000) 不扫描的数据文件 4096 (0x1000) 离线文件，主要是共享文件可在脱机状态下使用 1 (0x1) 只读文件 1024 (0x400) 符号链接文件 512 (0x200) 稀疏文件，文件中出现大量的0数据 4 (0x4) 操作系统文件 256 (0x100) 临时文件 65536 (0x10000) 虚拟属性，系统保留属性

参数	类型	说明
alias	string	字符串类型。参考目录别名。
file_name	string	字符串类型。文件名称。

返回：int

fileCopy(src_alias, src_name, dest_alias, dest_name, fail_if_exists)

文件拷贝。注：目标文件名的路径必须存在，否则会复制不成功。

参数	类型	说明
src_alias	string	源文件目录别名，字符串类型。参考目录别名。
src_name	bool	源文件名，字符串类型。源文件名。
dest_alias	string	目标文件目录别名，字符串类型。参考目录别名。
dest_name	string	目标文件名，字符串类型。源文件名。
fail_if_exists	string	object

返回：bool

fileDateToDateTime(filename)

日期时间处理函数。

参数	类型	说明
filename	int

返回：datetime

fileDelete(alias, file_name)

删除文件。

参数	类型	说明
alias	string	字符串类型。参考目录别名。
file_name	string	字符串类型。文件名称。

返回：bool

fileExists(alias, file_name)

判定文件是否存在。

参数	类型	说明
alias	string	字符串类型。参考目录别名。
file_name	string	字符串类型。文件名称。

返回：bool

fileInfo(alias, name)

获取指定文件基本信息。

参数	类型	说明
alias	string	字符串，目录别名，可传入空字符串。
name	string	字符串，文件路径。

返回：array

fileList(alias, file_name)

列出目录。

参数	类型	说明
alias	string	字符串类型。参考目录别名。
file_name	string	字符串类型。查找的文件名称，支持通配符。

返回：array

fileMode(alias, file_name)

获取文件模式数值。此函数在Windows上与FileAttr表现一致，具体可以参考FileAttr中的相关说明。在Linux上采用Linux的原始定义。仅NG客户端中支持。

参数	类型	说明
alias	string
file_name	string

返回：int

fileMove(src_alias, srcname, dest_alias, destname, flag, return_value)

文件移动，指定的目标路径必须已存在（路径不存在时，移动失败），移动成功后，原文件不再存在，只在目标路径中保存。 相比filerename而言支持跨卷移动。

参数	类型	说明
src_alias	string	源文件目录别名，参考FAQ：目录别名
srcname	int	源文件名
dest_alias	string	目标目录别名
destname	string	目标文件名
flag	string	可选参数，移动模式。
return_value	不支持跨卷移动，目标文件已存在时移动失败，默认值	object

返回：bool

fileRename(alias, file_name, new_name)

文件更名，也可用于文件的移动（大多数情况下不支持跨卷移动）。

参数	类型	说明
alias	string	字符串类型。参考目录别名。
file_name	string	字符串类型。文件名称。
new_name	string	字符串类型。更名后的文件名称。

返回：bool

fileSize(alias, file_name)

取得文件大小。

参数	类型	说明
alias	string	字符串类型。参考目录别名。
file_name	string	字符串类型。文件名称。

返回：int

fileTime(alias, file_name)

取得文件的最后更新时间。

参数	类型	说明
alias	string	字符串类型。参考目录别名。
file_name	string	字符串类型。文件名称。

返回：datetime

getDeviceFree(alias, name)

获取指定路径所在设备的剩余存储空间信息。

参数	类型	说明
alias	string	字符串，目录别名，可传入空字符串。
name	string	字符串，文件路径

返回：array

getdeviceinfo(alias, name)

获取指定路径所在设备的存储空间等信息。

参数	类型	说明
alias	string	字符串，目录别名，可传入空字符串。
name	string	字符串，文件路径

返回：array

importFile(filename, arg2, arg3, data2)

文件访问函数相关函数。

参数	类型	说明
filename	int
arg2	string
arg3	array
data2	bool

返回：bool

readFile(filename, arg2, arg3, arg4, size, data)

文件访问函数相关函数。

参数	类型	说明
filename	int
arg2	string
arg3	int
arg4	int
size	string
data	int

返回：bool

removeDir(alias, dir_name)

删除目录。只能删除空目录；如果要删除的目录下有文件，删除失败。

参数	类型	说明
alias	string	字符串类型。参考目录别名。
dir_name	string	字符串类型。创建的目录名。

返回：bool

setFileAge(alias, file_name, age)

设置文件的时间。

参数	类型	说明
alias	string	字符串类型。参考目录别名。
file_name	int	字符串类型。文件名称。
age	string	整数类型，该参数可以用DateTimeToFileDate转换转换获取

返回：int

setFileAttr(alias, file_name, attr)

设置文件的属性。

参数	类型	说明
alias	string	字符串类型。参考目录别名。
file_name	string	字符串类型。文件名称。
attr	any	整数类型，文件的属性，为各种文件属性的和，可以参考WINDOWS API，详见FileAttr。

返回：any

setFileMode(alias, file_name, mode)

设置文件的模式。仅NG客户端中支持。

参数	类型	说明
alias	string
file_name	int
mode	any

返回：int

setFileTime(alias, file_name, time)

设置文件的时间。

参数	类型	说明
alias	string	字符串类型。参考目录别名。
file_name	datetime	字符串类型。文件名称。
time	string	日期类型，文件时间

返回：int

TS_ModuleInfo(n)

返回进程以及TSLInterp.dll的时间以及大小信息。如果有系统权限信息，用TS_ModuleInfo(1)返回所有模块的文件名和时间。

参数	类型	说明
n	any	整型，获取系统信息类型；无参或为0时，返回进程以及TSLInterp.dll的时间以及大小信息；为1时，若有系统权限信信息，则返回所有模块的文件名和时间

返回：array

用户和函数相关函数

writeToLog(dir, sub_dir, value)

向虚拟目录写日志。其中Dir为虚拟目录名，SubDir为文件名，成功写入日志后，会生成命名为’SubDir’+写入日期+’.log’的TXT文件，文件内容为写入时间->Value。用户使用其应当申请好服务器权限。 20250512升级：优化多个线程同时写入时存在丢失情况： 1、增加重试次数，重试20次间隔0.5秒。 2、增加返回内容。 注意：在极端情况下（超多多线程下同时写入）可能还会存在写入失败情况，此时可通过返回结果继续处理

参数	类型	说明
dir	string	字符串，虚拟目录别名，一般在安装目录\Tinysoft\Analyse.NET\Plugin\filemgr.ini中进行配置。如果没有配置别名，该参数赋值为空字符""。
sub_dir	string	字符串，文件名
value	string	字符串，需要写入日志的内容

返回：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

示例

// 读取本地文件的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

示例

// 导出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

示例

// 导入"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

示例

return loadTableEx('repitle');
// 返回: repitle为保存好的用户数据