进程服务

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 公司的商标。所有其他商标均为各自所有者的财产。