进程服务
Process
服务允许您启动进程、跟踪它们的输出等。
可用操作
构造函数
Process()
分配并返回一个新的 Process 对象。
close
close(): void
释放与进程关联的资源。建议您在完成进程后立即调用此函数。
closeWriteChannel
closeWriteChannel(): void
安排进程的 stdin 通道关闭。一旦将所有数据写入进程,通道将关闭。调用此函数后,任何尝试写入进程的操作都将无效。有关详细信息,请参阅 QProcess::closeWriteChannel()
。
exec
exec(filePath: string, arguments: string[], throwOnError: boolean): number
在 filePath
处执行程序并使用给定的参数列表,直到进程结束。如果发生错误(例如,在 filePath
处没有可执行文件)并且 throwOnError
为 true,则将抛出 JavaScript 异常。否则(默认),如果发生错误,将返回 -1。正常返回码是进程的退出码。
exitCode
exitCode(): number
返回进程的退出码。这对于从通过 start()
启动的进程而不是通过 exec()
启动的进程检索退出码是必要的。
getEnv
getEnv(varName: string): string
返回进程中变量 varName
的值。
kill
kill(): void
杀死进程,使其立即退出。
readLine
readLine(): string
从进程输出中读取并返回一行文本,不包括换行符。
atEnd
atEnd(): boolean
如果进程输出中没有更多数据可读,则返回 true,否则返回 false。
readStdErr
readStdErr(): string
读取并返回进程标准错误通道中的所有数据。
readStdOut
readStdOut(): string
读取并返回进程标准输出通道中的所有数据。
setCodec
setCodec(codec)
将文本编解码器设置为 codec
。编解码器用于从和向进程进行读写。支持的编解码器与 QTextCodec
相同,例如:“UTF-8”、“UTF-16” 和 “ISO 8859-1”。
setEnv
setEnv(varName: string, varValue: string): string
在进程环境中设置变量 varName
的值为 varValue
。如果在此调用之前启动进程,则此操作有效。
setWorkingDirectory
setWorkingDirectory(path: string): void
设置进程启动的目录。如果在此调用之前启动进程,则此操作有效。
start
start(filePath: string, arguments: string[]): boolean
在 filePath
路径处启动程序,并使用提供的参数列表。如果能够启动进程,则返回 true
;否则返回 false
。
注意: 这个调用在启动进程后立即返回,并且仅在您需要与正在运行的进程交互时使用。大多数情况下,您想使用 exec()
而不是它。
终止
terminate(): void
尝试终止进程。这并不能保证进程会立即退出;如果您需要这样做,请使用 kill()
。
waitForFinished
waitForFinished(timeout: number): boolean
阻塞,直到进程完成或已经过去 timeout
毫秒(默认为 30000)。如果进程已完成,则返回 true;如果操作已超时,则返回 false。调用此函数仅在通过 start()
启动进程有意义,而不是通过 exec()
。
workingDirectory
workingDirectory(): string
返回将启动进程的目录。
write
write(data: string): void
将 data
写入进程的输入通道。
writeLine
writeLine(data: string): void
将 data
写入进程的输入通道,之后跟一个或多个换行符。
©2023 Qt 公司版权所有。所包含的文档贡献的版权属于其各自的所有者。本程序提供的文档是根据自由软件基金会发布的 GNU 自由文档许可版 1.3 的条款提供的。Qt 以及相应的商标是芬兰和/或其他国家的 Qt 公司的商标。所有其他商标均为各自所有者的财产。