13 KiB
运行时 / 文件与目录
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