703 lines
16 KiB
Markdown
703 lines
16 KiB
Markdown
# Builtin - 资源访问函数
|
||
|
||
## 函数
|
||
|
||
### `sqlErrorMsg()`
|
||
|
||
获取最近一次 SQL 错误信息。
|
||
|
||
返回：string
|
||
|
||
### `sqlCloseConn()`
|
||
|
||
关闭 SQL 连接。
|
||
|
||
返回：any
|
||
|
||
## 文件访问函数
|
||
|
||
### `fileAttrToStr(attr)`
|
||
|
||
将输入值转换为字符串。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------ | ---- | ---- |
|
||
| `attr` | any | |
|
||
|
||
返回：string
|
||
|
||
### `fileModeToStr(attr)`
|
||
|
||
将输入值转换为字符串。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------ | ---- | ---- |
|
||
| `attr` | any | |
|
||
|
||
返回：string
|
||
|
||
### `strToFileAttr(str)`
|
||
|
||
将字符串转换为对应类型。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ----- | ------ | ---- |
|
||
| `str` | string | |
|
||
|
||
返回：string
|
||
|
||
### `strToFileMode(str)`
|
||
|
||
将字符串转换为对应类型。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ----- | ------ | ---- |
|
||
| `str` | string | |
|
||
|
||
返回：string
|
||
|
||
## 导入导出类型函数
|
||
|
||
### `ftCsv()`
|
||
|
||
导入导出类型函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `ftXls()`
|
||
|
||
导入导出类型函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `ftXls2()`
|
||
|
||
导入导出类型函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `ftXls3()`
|
||
|
||
导入导出类型函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `ftStream()`
|
||
|
||
文件访问函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `ftString()`
|
||
|
||
导入导出类型函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `ftXml()`
|
||
|
||
导入导出类型函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `ftdbf()`
|
||
|
||
导入导出类型函数相关函数。
|
||
|
||
返回：any
|
||
|
||
## 文件读写类型函数
|
||
|
||
### `rwByte()`
|
||
|
||
文件访问函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `rwInt()`
|
||
|
||
文件读写类型函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `rwReal()`
|
||
|
||
文件读写类型函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `rwStr()`
|
||
|
||
文件读写类型函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `rwObj()`
|
||
|
||
文件读写类型函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `rwRaw()`
|
||
|
||
文件访问函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `rwBinary()`
|
||
|
||
文件读写类型函数相关函数。
|
||
|
||
返回：any
|
||
|
||
## 网络访问以及相关函数
|
||
|
||
### `getUrl(src_url, parse_url)`
|
||
|
||
网络访问以及相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ----------- | ------ | ---- |
|
||
| `src_url` | string | |
|
||
| `parse_url` | string | |
|
||
|
||
返回：any
|
||
|
||
### `createHttpSession()`
|
||
|
||
网络访问以及相关函数相关函数。
|
||
|
||
返回：any
|
||
|
||
## 进程相关函数
|
||
|
||
### `sysputenv(env_value)`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ----------- | ------ | ---- |
|
||
| `env_value` | string | |
|
||
|
||
返回：any
|
||
|
||
### `sysParamStr(i)`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ---- | ---- | ---- |
|
||
| `i` | any | |
|
||
|
||
返回：any
|
||
|
||
### `sysErrorMessage(arg1)`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------ | ---- | ---- |
|
||
| `arg1` | any | |
|
||
|
||
返回：any
|
||
|
||
### `sysgetenv(name)`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------ | ------ | ---- |
|
||
| `name` | string | |
|
||
|
||
返回：any
|
||
|
||
### `sysWaitForMultipleObjects(objects, b_wait_all, wait_ms)`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------------ | ----- | ---- |
|
||
| `objects` | array | |
|
||
| `b_wait_all` | any | |
|
||
| `wait_ms` | any | |
|
||
|
||
返回：any
|
||
|
||
### `sysCreateMutex(mutex_name)`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------------ | ------ | ---- |
|
||
| `mutex_name` | string | |
|
||
|
||
返回：any
|
||
|
||
### `sysReleaseMutex(ret)`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ----- | ---- | ---- |
|
||
| `ret` | any | |
|
||
|
||
返回：any
|
||
|
||
### `sysProcessId()`
|
||
|
||
获取当前进程 ID（PID）。
|
||
|
||
返回：any
|
||
|
||
### `sysParamcount()`
|
||
|
||
获取命令行传入参数的个数。
|
||
|
||
返回：any
|
||
|
||
### `sysThreadId()`
|
||
|
||
获取当前线程 ID。
|
||
|
||
返回：any
|
||
|
||
### `sleep(arg1)`
|
||
|
||
让当前线程休眠指定毫秒数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------ | ---- | ---- |
|
||
| `arg1` | any | |
|
||
|
||
返回：void
|
||
|
||
### `sysWaitForSingleObject(hand1, arg2)`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------- | ---- | ---- |
|
||
| `hand1` | any | |
|
||
| `arg2` | any | |
|
||
|
||
返回：any
|
||
|
||
### `sysGetenvs()`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `sysexecGetenvs()`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `sysexecDeletepipe(hand)`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------ | ---- | ---- |
|
||
| `hand` | any | |
|
||
|
||
返回：any
|
||
|
||
### `sysexecNewpipe(arg1)`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------ | ---- | ---- |
|
||
| `arg1` | any | |
|
||
|
||
返回：any
|
||
|
||
### `dbglocalrunning()`
|
||
|
||
返回本地解释器正在运行的任务列表与调用栈信息。
|
||
|
||
返回：array
|
||
|
||
### `dbglocalcancel(task_id)`
|
||
|
||
根据任务 ID 终止本地运行中的任务。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| --------- | ------ | ---- |
|
||
| `task_id` | string | |
|
||
|
||
返回：any
|
||
|
||
### `sysThreadSelf()`
|
||
|
||
获取当前线程 ID（Linux 下为 pthread_t）。
|
||
|
||
返回：any
|
||
|
||
### `syslinuxkrnlclosemutex(name, isprivate)`
|
||
|
||
关闭并清理指定互斥量（Linux），用于移除互斥相关的系统信号量与临时文件。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ----------- | ------ | ---- |
|
||
| `name` | string | |
|
||
| `isprivate` | any | |
|
||
|
||
返回：any
|
||
|
||
### `sysSetThreadPriority(arg1[, arg2])`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------ | ---- | ---- |
|
||
| `arg1` | any | |
|
||
| `arg2` | any | |
|
||
|
||
返回：any
|
||
|
||
### `sysGetThreadPriority(pri[, arg2])`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------ | ---- | ---- |
|
||
| `pri` | any | |
|
||
| `arg2` | any | |
|
||
|
||
返回：any
|
||
|
||
### `sysGetProcessList()`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `sysGetProcessListw()`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `sysGetThreadName([arg1])`
|
||
|
||
获取线程名称。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------ | ---- | ---- |
|
||
| `arg1` | any | |
|
||
|
||
返回：string
|
||
|
||
### `sysGetThreads()`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `sysPPid()`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `sysGetSubProcesses()`
|
||
|
||
进行字符串提取或替换处理。
|
||
|
||
返回：string
|
||
|
||
### `sysPidOfTid(tid)`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ----- | ---- | ---- |
|
||
| `tid` | any | |
|
||
|
||
返回：any
|
||
|
||
### `sysPidOfHandle(handle)`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| -------- | ---- | ---- |
|
||
| `handle` | any | |
|
||
|
||
返回：any
|
||
|
||
### `sysHandleOfPid(arg1)`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------ | ---- | ---- |
|
||
| `arg1` | any | |
|
||
|
||
返回：any
|
||
|
||
### `sysGetLastError()`
|
||
|
||
获取最近一次系统错误码。
|
||
|
||
返回：any
|
||
|
||
### `sysCmdLine()`
|
||
|
||
获取当前进程命令行。
|
||
|
||
返回：string
|
||
|
||
### `sysClientInfo()`
|
||
|
||
获取客户端信息。
|
||
|
||
返回：any
|
||
|
||
## 本地资源相关函数
|
||
|
||
### `sysExecName()`
|
||
|
||
获取当前执行程序的完整路径。
|
||
|
||
返回：string
|
||
|
||
### `pluginPath()`
|
||
|
||
获取插件目录路径。
|
||
|
||
返回：string
|
||
|
||
### `getlogicdrive()`
|
||
|
||
本地资源相关函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `createlink(link_name, target_name, hard)`
|
||
|
||
本地资源相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------------- | ------ | ---- |
|
||
| `link_name` | string | |
|
||
| `target_name` | string | |
|
||
| `hard` | any | |
|
||
|
||
返回：any
|
||
|
||
### `realpath(name)`
|
||
|
||
本地资源相关函数相关函数。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------ | ------ | ---- |
|
||
| `name` | string | |
|
||
|
||
返回：any
|
||
|
||
## 数据库访问函数
|
||
|
||
### `sqlCloseConn(db_alias)`
|
||
|
||
主动关闭指定别名的数据库链接或者关闭所有数据库链接。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ---------- | ------ | ---------------------- |
|
||
| `db_alias` | string | 数据库别名，可选参数。 |
|
||
|
||
返回：any
|
||
|
||
## 文件访问函数
|
||
|
||
### `exportFile(type, alias, file_name, data, include_header, include_index)`
|
||
|
||
将数据导出为文件。支持将INF以及NAN导出到Excel，INF对应为EXCEL的DIV0，NAN对应为NA
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ---------------- | ------ | --------------------------------------------------------------------------------------------- |
|
||
| `type` | any | 整数类型，参考FAQ：导入导出类型函数。 |
|
||
| `alias` | string | 字符串类型，参考目录别名；如果没有配置用户别名，可直接在FileName中写上路径，该字段赋值为""。 |
|
||
| `file_name` | string | 字符串类型。文件名称。如果没有给别名，可以在FileName中把路径写上，比如"D:\\test\\test1.xls"。 |
|
||
| `data` | array | 输出的数据内容。 |
|
||
| `include_header` | bool | object |
|
||
| `include_index` | bool | object |
|
||
|
||
返回：string|bool
|
||
|
||
### `importFile(type, alias, file_name, data, include_header, include_index, force_single, sheet_name)`
|
||
|
||
从文件中导入数据。对EXCEL文件自动识别.xls或者.xlsx的文件格式，支持将INF以及NAN导入
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------- |
|
||
| `type` | any | 整数类型。参考FAQ：导入导出类型函数 |
|
||
| `alias` | string | 字符串类型。参考目录别名。 |
|
||
| `file_name` | string | 字符串类型。文件名称。 |
|
||
| `data` | array | 输出参数，存贮导入的数据。当导入成功的时候，数据将存放在Data中，否则将存贮返回的错误信息。 |
|
||
| `include_header` | bool | object |
|
||
| `include_index` | bool | object |
|
||
| `force_single` | bool | object |
|
||
| `sheet_name` | string | 字符串或者整数。在导入XLS文件的时候，可以指定从哪个SHEET里导入数据，可以以第几个SHEET或者SHEET名来设置SHEET参数。SHEET的序列从1开始。 |
|
||
|
||
返回：bool
|
||
|
||
### `parseHtml(html, parsed, attr_name_is_index)`
|
||
|
||
将指定的Html字符串解析成为类似于DOM格式的结构。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| -------------------- | ------ | ------------------------------ |
|
||
| `html` | string | 字符串类型，所需解析的HTML串。 |
|
||
| `parsed` | array | 存放返回的类DOM结构。 |
|
||
| `attr_name_is_index` | bool | object |
|
||
|
||
返回：string
|
||
|
||
## 进程相关函数
|
||
|
||
### `sysTerminate(ret_code, handle)`
|
||
|
||
终止进程。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ---------- | ------ | ------------------------------------------ |
|
||
| `ret_code` | string | 整数，终止进程返回的代码。 |
|
||
| `handle` | any | 整数，终止进程的句柄。缺省为终止自身进程。 |
|
||
|
||
返回：any
|
||
|
||
### `sysCloseHandle(handle)`
|
||
|
||
关闭一个句柄，如互斥锁，文件句柄等。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| -------- | ---- | -------------- |
|
||
| `handle` | any | 整数，句柄编号 |
|
||
|
||
返回：bool
|
||
|
||
### `dbglocalrunning(return_value)`
|
||
|
||
获得当前所有的任务列表以及堆栈信息，主要用于web等检查在运行中的任务。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| -------------- | ----- | --------------------------------------------------------------------- |
|
||
| `return_value` | array | 获得当前所有的任务列表以及堆栈信息，主要用于web等检查在运行中的任务。 |
|
||
|
||
返回：array
|
||
|
||
### `sysGetProcessList(return_value)`
|
||
|
||
获取当前进程列表信息
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| -------------- | ----- | -------------------------------------------------------------------------- |
|
||
| `return_value` | array | 获取成功，返回包含进程信息的数组；否则，返回0。 返回结果中各字段含义如下： |
|
||
|
||
返回：array
|
||
|
||
### `sysGetProcessListw(return_value)`
|
||
|
||
获取当前进程列表信息，信息中字符串为宽字节字符串
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| -------------- | ----- | -------------------------------------------------------------------------- |
|
||
| `return_value` | array | 获取成功，返回包含进程信息的数组；否则，返回0。 返回结果中各字段含义如下： |
|
||
|
||
返回：array
|
||
|
||
## 进程相关函数 / 获取COM进程
|
||
|
||
### `sysGetWndOfCaption(cap, is_contain_string)`
|
||
|
||
获得所有标题窗口串包含或者等于指定串的所有窗口句柄。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------------------- | ------ | ---------------------------------------------- |
|
||
| `cap` | string | 字符串，窗口的标题。 |
|
||
| `is_contain_string` | any | 布尔类型，是否包含，可选参数参数，默认是包含。 |
|
||
|
||
返回：array
|
||
|
||
### `sysGetPidtidOfWnd(wnd, thread_id)`
|
||
|
||
获得窗口句柄的进程ID, 通过ThreadId可输出线程id
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ----------- | ------ | ------------------------------------------------ |
|
||
| `wnd` | any | 整型，窗口句柄。 |
|
||
| `thread_id` | string | 输出值，整型，线程号，给定该参数可以获取线程ID。 |
|
||
|
||
返回：any
|
||
|
||
## 未细分函数
|
||
|
||
### `iniWriteBool()`
|
||
|
||
INI文件处理函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `iniWriteDate()`
|
||
|
||
日期时间处理函数。
|
||
|
||
返回：datetime
|
||
|
||
### `iniWriteDateTime()`
|
||
|
||
日期时间处理函数。
|
||
|
||
返回：datetime
|
||
|
||
### `iniWriteFloat()`
|
||
|
||
INI文件处理函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `iniWriteInteger()`
|
||
|
||
INI文件处理函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `iniWriteTime()`
|
||
|
||
日期时间处理函数。
|
||
|
||
返回：datetime
|
||
|
||
### `iniWriteString()`
|
||
|
||
INI文件处理函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `iniDeleteKey()`
|
||
|
||
INI文件处理函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `sysTerminate()`
|
||
|
||
进程相关函数相关函数。
|
||
|
||
返回：any
|
||
|
||
### `sysSetThreadName(arg1[, arg2])`
|
||
|
||
设置线程名称（Linux 仅支持当前线程）。
|
||
|
||
| 参数 | 类型 | 说明 |
|
||
| ------ | ------ | ---- |
|
||
| `arg1` | string | |
|
||
| `arg2` | any | |
|
||
|
||
返回：string
|