QProcess Class

成员函数文档

[explicit] QProcess::QProcess(QObject *parent = nullptr)

使用给定的parent 创建一个QProcess对象。

[virtual noexcept] QProcess::~QProcess()

销毁QProcess 对象，即终止该进程。

请注意，该函数在进程终止之前不会返回。

QStringList QProcess::arguments() const

返回该进程上次启动时使用的命令行参数。

另请参阅 setArguments() 和start()。

[override virtual] qint64 QProcess::bytesToWrite() const

重新实现了：QIODevice::bytesToWrite() const。

[since 6.0] std::function<void ()> QProcess::childProcessModifier() const

返回先前通过调用 `setChildProcessModifier()` 设置的修饰函数。

该函数于 Qt 6.0 中引入。

另请参阅 setChildProcessModifier() 和unixProcessParameters()。

[override virtual] void QProcess::close()

重写了：QIODevice::close()。

关闭与该进程的所有通信并终止该进程。调用此函数后，QProcess 将不再发出readyRead() 事件，且无法再读写数据。

void QProcess::closeReadChannel(QProcess::ProcessChannel channel)

关闭读取通道channel 。调用此函数后，QProcess 将不再通过该通道接收数据。已接收的任何数据仍可供读取。

如果您对该进程的输出不感兴趣，请调用此函数以节省内存。

另请参阅 closeWriteChannel() 和setReadChannel()。

void QProcess::closeWriteChannel()

安排关闭QProcess 的写通道。一旦所有数据都已写入该进程，该通道将关闭。调用此函数后，任何尝试向该进程写入数据的操作都将失败。

对于那些在通道关闭前持续读取输入数据的程序，关闭写通道是必要的。例如，程序“more”用于在 Unix 和 Windows 系统上通过控制台显示文本数据。但在QProcess 的写通道关闭之前，它不会显示任何文本数据。示例：

QProcess more;
more.start("more");
more.write("Text to display");
more.closeWriteChannel();
// QProcess will emit readyRead() once "more" starts printing

调用start() 时会隐式打开写通道。

另请参阅 closeReadChannel()。

QProcess::CreateProcessArgumentModifier QProcess::createProcessArgumentsModifier() const

返回一个先前设置的CreateProcess 修饰函数。

另请参阅 setCreateProcessArgumentsModifier() 和QProcess::CreateProcessArgumentModifier 。

QProcess::ProcessError QProcess::error() const

返回上次发生的错误类型。

另请参阅 state()。

[signal] void QProcess::errorOccurred(QProcess::ProcessError error)

当进程发生错误时，会发出此信号。指定的error 描述了发生的错误类型。

[static] int QProcess::execute(const QString &program, const QStringList &arguments = {})

在新的进程中启动程序 `program `，并传入参数 `arguments `，等待其执行完毕，然后返回该进程的退出代码。新进程写入控制台的任何数据都会转发给调用进程。

环境和工作目录均继承自调用进程。

参数处理方式与相应的start() 重载函数完全相同。

如果无法启动进程，则返回 -2。如果进程崩溃，则返回 -1。否则，返回该进程的退出代码。

另请参阅 start()。

int QProcess::exitCode() const

返回最后一个已结束进程的退出代码。

除非 `exitStatus()` 返回 `NormalExit`，否则该值无效。

QProcess::ExitStatus QProcess::exitStatus() const

返回最后一个已完成的进程的退出状态。

在 Windows 系统上，如果该进程是由另一个应用程序通过 TerminateProcess() 终止的，除非退出代码小于 0，否则该函数仍将返回NormalExit 。

[noexcept, since 6.7] void QProcess::failChildProcessModifier(const char *description, int error = 0)

可在修饰符集中使用这些函数，配合 `setChildProcessModifier()` 来指示已遇到错误情况。当修饰符调用这些函数时，QProcess 将在父进程中发出 `errorOccurred()` 并传入代码 `QProcess::FailedToStart `。description 可用于在errorString()中包含一些信息以帮助诊断问题，通常是失败调用的名称，类似于C库函数perror() 。此外，error 参数可以是一个<errno.h> 错误代码，其文本形式也会被包含进去。

例如，一个子进程修饰符可以按以下方式为子进程准备一个额外的文件描述符：

process.setChildProcessModifier([fd, &process]() {
    if (dup2(fd, TargetFileDescriptor) < 0)
        process.failChildProcessModifier(errno, "aux comm channel");
});
process.start();

其中fd 是父进程中当前已打开的文件描述符。如果dup2() 系统调用导致EBADF 异常，则该进程的errorString() 可能显示为“子进程修饰符报告错误：辅助通信通道：文件描述符无效”。

该函数不会返回给调用方。若不在子进程修饰符中使用，或未使用正确的QProcess 对象，则会导致未定义行为。

该函数在 Qt 6.7 中引入。

另请参阅 setChildProcessModifier() 和setUnixProcessParameters()。

[signal] void QProcess::finished(int exitCode, QProcess::ExitStatus exitStatus = NormalExit)

当进程结束时会发出此信号。exitCode 是进程的退出代码（仅在正常退出时有效），exitStatus 是退出状态。进程结束之后，QProcess 中的缓冲区仍然完好无损。您仍然可以读取进程在结束前可能写入的任何数据。

另请参阅 exitStatus()。

QProcess::InputChannelMode QProcess::inputChannelMode() const

返回QProcess 标准输入通道的通道模式。

另请参见 setInputChannelMode() 和InputChannelMode 。

[override virtual] bool QProcess::isSequential() const

重新实现了：QIODevice::isSequential() const。

[slot] void QProcess::kill()

终止当前进程，使其立即退出。

在 Windows 系统上，kill() 调用 TerminateProcess 函数；而在 Unix 和 macOS 系统上，则向进程发送 SIGKILL 信号。

另请参阅 terminate()。

QString QProcess::nativeArguments() const

返回该程序的额外本机命令行参数。

另请参阅 setNativeArguments()。

[static] QString QProcess::nullDevice()

操作系统的空设备。

返回的文件路径使用本机目录分隔符。

另请参阅 QProcess::setStandardInputFile()、QProcess::setStandardOutputFile() 和QProcess::setStandardErrorFile()。

[override virtual] bool QProcess::open(QIODeviceBase::OpenMode mode = ReadWrite)

重写了：QIODevice::open （QIODeviceBase::OpenMode 模式）。

使用由 `setArguments()` 设置的参数，启动由 `setProgram()` 指定的程序。OpenMode 被设置为 `mode`。

此方法是start() 的别名，其存在仅是为了完全实现由QIODevice 定义的接口。

如果程序已启动，则返回true 。

另请参阅 start()、setProgram() 和setArguments()。

QProcess::ProcessChannelMode QProcess::processChannelMode() const

返回QProcess 标准输出和标准错误通道的通道模式。

另请参阅 setProcessChannelMode()、ProcessChannelMode 以及setReadChannel()。

QProcessEnvironment QProcess::processEnvironment() const

返回QProcess 将传递给其子进程的环境。如果未使用setProcessEnvironment()设置环境，则该方法返回一个对象，表示该环境将从父进程继承而来。

另请参阅 setProcessEnvironment()、QProcessEnvironment::inheritsFromParent() 以及Environment variables 。

qint64 QProcess::processId() const

返回正在运行的进程的本机进程标识符（如果存在）。如果当前没有进程正在运行，则返回0 。

QString QProcess::program() const

返回该进程最后一次启动时执行的程序。

另请参阅 setProgram() 和start()。

QByteArray QProcess::readAllStandardError()

无论当前读取通道为何，该函数都会将进程标准错误流中所有可用的数据作为QByteArray 返回。

另请参阅 readyReadStandardError()、readAllStandardOutput()、readChannel() 和setReadChannel()。

QByteArray QProcess::readAllStandardOutput()

无论当前读取通道为何，该函数都会将进程标准输出中所有可用的数据作为QByteArray 返回。

另请参阅 readyReadStandardOutput()、readAllStandardError()、readChannel() 和setReadChannel()。

QProcess::ProcessChannel QProcess::readChannel() const

返回QProcess 的当前读取通道。

另请参阅 setReadChannel()。

[override virtual protected] qint64 QProcess::readData(char *data, qint64 maxlen)

重写了：QIODevice::readData(char *data, qint64 maxSize)。

[private signal] void QProcess::readyReadStandardError()

当进程通过其标准错误通道（stderr ）提供了新数据时，会发出此信号。无论当前的read channel 状态如何，都会发出此信号。

另请参阅 readAllStandardError() 和readChannel()。

[private signal] void QProcess::readyReadStandardOutput()

当进程通过其标准输出通道（stdout ）提供新数据时，会发出此信号。无论当前的read channel 如何，该信号都会被发出。

另请参阅 readAllStandardOutput() 和readChannel()。

void QProcess::setArguments(const QStringList &arguments)

设置arguments ，以便在启动进程时将其传递给被调用程序。必须在调用start()之前调用此函数。

另请参阅 start()、setProgram() 和arguments()。

[since 6.0] void QProcess::setChildProcessModifier(const std::function<void ()> &modifier)

为子进程设置modifier 函数，适用于Unix系统（包括macOS；关于Windows，请参阅setCreateProcessArgumentsModifier()）。当fork() 或vfork() 完成，且QProcess 已为子进程设置好标准文件描述符后，但在execve() 之前，该函数将在子进程的start()内部被调用，其中modifier 参数指定的函数将被调用。

以下是一个将子进程配置为无特权运行的示例：

void runSandboxed(const QString &name, const QStringList &arguments)
{
    QProcess proc;
    proc.setChildProcessModifier([] {
        // Drop all privileges in the child process, and enter
        // a chroot jail.
        ::setgroups(0, nullptr);
        ::chroot("/run/safedir");
        ::chdir("/");
        ::setgid(safeGid);
        ::setuid(safeUid);
        ::umask(077);
    });
    proc.start(name, arguments);
    proc.waitForFinished();
}

如果修饰函数遇到失败情况，可以使用failChildProcessModifier() 向QProcess 调用者报告该情况。此外，它还可以使用其他方法停止进程，例如_exit() 或abort() 。

子进程的某些属性，例如关闭所有多余的文件描述符或与控制 TTY 断开连接，可以通过使用setUnixProcessParameters() 更轻松地实现，该函数能够检测到失败并报告FailedToStart 状态。 该修饰符可用于更改子进程的某些不常见的属性，例如设置额外的文件描述符。如果同时设置了子进程修饰符和 Unix 进程参数，则在应用这些参数之前会先执行该修饰符。

该函数在 Qt 6.0 中引入。

另请参阅 childProcessModifier()、failChildProcessModifier() 和setUnixProcessParameters()。

void QProcess::setCreateProcessArgumentsModifier(QProcess::CreateProcessArgumentModifier modifier)

设置CreateProcess Win32 API调用的modifier 。传递QProcess::CreateProcessArgumentModifier() 可移除先前设置的值。

另请参阅 createProcessArgumentsModifier()、QProcess::CreateProcessArgumentModifier 以及setChildProcessModifier()。

void QProcess::setInputChannelMode(QProcess::InputChannelMode mode)

将QProcess 标准输入通道的通道模式设置为指定的mode 。下次调用start()时将使用此模式。

另请参阅 inputChannelMode() 和InputChannelMode 。

void QProcess::setNativeArguments(const QString &arguments)

为程序设置额外的本机命令行arguments 。

在某些操作系统中，系统 API 用于将命令行arguments 原生传递给子进程时，默认使用单个字符串；因此，可能会存在无法通过 `QProcess` 的可移植列表式 API 传递的命令行。在这种情况下，必须使用此函数设置一个字符串，该字符串将以空格作为分隔符，附加到由常规参数列表组成的字符串之后。

另请参阅 nativeArguments()。

void QProcess::setProcessChannelMode(QProcess::ProcessChannelMode mode)

将QProcess 的标准输出和标准错误通道的通道模式设置为指定的mode 。下次调用start()时将使用此模式。例如：

QProcess builder;
builder.setProcessChannelMode(QProcess::MergedChannels);
builder.start("make",QStringList()<< "-j2");

if(!builder.waitForFinished())
    qDebug() << "Make failed:" << builder.errorString();
else
    qDebug() << "Make output:" << builder.readAll();

另请参阅 processChannelMode()，ProcessChannelMode 以及setReadChannel()。

void QProcess::setProcessEnvironment(const QProcessEnvironment &environment)

设置QProcess 将传递给子进程的environment 。

例如，以下代码添加了环境变量TMPDIR ：

QProcess process;
QProcessEnvironment env = QProcessEnvironment::systemEnvironment();
env.insert("TMPDIR", "C:\\MyApp\\temp"); // Add an environment variable
process.setProcessEnvironment(env);
process.start("myapp");

请注意，在 Windows 系统中，环境变量名称不区分大小写。

另请参阅 processEnvironment()、QProcessEnvironment::systemEnvironment() 和Environment variables 。

[protected] void QProcess::setProcessState(QProcess::ProcessState state)

将QProcess 的当前状态设置为指定的state 。

另请参阅 state()。

void QProcess::setProgram(const QString &program)

设置启动进程时要使用的program 。必须在调用start()之前调用此函数。

如果 `program ` 是绝对路径，则指定将要启动的具体可执行文件。相对路径将根据平台特性进行解析，其中包括搜索 `PATH ` 环境变量（详情请参见Finding the Executable ）。

另请参阅 start()、setArguments()、program() 以及QStandardPaths::findExecutable()。

void QProcess::setReadChannel(QProcess::ProcessChannel channel)

将QProcess 的当前读取通道设置为指定的channel 。当前输入通道被以下函数使用：read()、readAll()、readLine() 和getChar()。它还决定了哪个通道会触发QProcess 发出readyRead()。

另请参阅 readChannel()。

void QProcess::setStandardErrorFile(const QString &fileName, QIODeviceBase::OpenMode mode = Truncate)

将进程的标准错误重定向到文件fileName 。当重定向生效后，标准错误读取通道将被关闭：使用read() 从该通道读取将始终失败，使用readAllStandardError() 同样会失败。如果mode 的值为 Append，则向该文件追加内容；否则，文件将被截断。

有关文件打开方式的更多信息，请参阅setStandardOutputFile()。

注意：如果调用setProcessChannelMode() 时传入的参数为QProcess::MergedChannels ，则此函数将不起作用。

另请参阅 setStandardInputFile()、setStandardOutputFile() 和setStandardOutputProcess()。

void QProcess::setStandardInputFile(const QString &fileName)

将进程的标准输入重定向到由fileName 指定的文件。当输入重定向生效时，QProcess 对象将处于只读模式（调用write()将引发错误）。

若要让进程立即读取 EOF，请在此处调用nullDevice()。这比在写入任何数据前使用closeWriteChannel() 更为简洁，因为它可以在进程启动前就完成配置。

如果在调用start() 时文件fileName 不存在或不可读，则进程启动将失败。

在进程启动后调用 setStandardInputFile() 不会产生任何效果。

另请参阅 setStandardOutputFile()、setStandardErrorFile() 和setStandardOutputProcess()。

void QProcess::setStandardOutputFile(const QString &fileName, QIODeviceBase::OpenMode mode = Truncate)

将进程的标准输出重定向到文件fileName 。当重定向生效后，标准输出读取通道将被关闭：使用read()从中读取将始终失败，readAllStandardOutput()也是如此。

若要丢弃进程的所有标准输出，请在此处传入 `nullDevice()`。这比单纯不读取标准输出更为高效，因为不会填满任何 `QProcess ` 缓冲区。

如果在调用start() 时文件fileName 不存在，则会创建该文件。如果无法创建，则启动将失败。

如果文件存在且mode 为QIODeviceBase::Truncate ，则文件将被截断。否则（如果mode 为QIODeviceBase::Append ），文件将被追加写入。

在进程启动后调用 setStandardOutputFile() 不会产生任何效果。

如果fileName 为空字符串，则停止重定向标准输出。这在重定向后恢复标准输出时非常有用。

另请参阅 setStandardInputFile()、setStandardErrorFile() 和setStandardOutputProcess()。

void QProcess::setStandardOutputProcess(QProcess *destination)

将该进程的标准输出流通过管道传输到destination 进程的标准输入。

以下 shell 命令：

command1 | command2

可以通过QProcess 并使用以下代码来实现：

QProcess process1;
QProcess process2;

process1.setStandardOutputProcess(&process2);

process1.start("command1");
process2.start("command2");

[since 6.6] void QProcess::setUnixProcessParameters(const QProcess::UnixProcessParameters &params)

在 Unix 系统上，将子进程的额外设置和参数设为params 。该函数可用于让QProcess 在启动目标可执行文件之前修改子进程。

该函数可用于更改子进程的某些属性，例如关闭所有多余的文件描述符、更改子进程的优先级（nice 级别），或断开与控制终端（TTY）的连接。 若需对子进程进行更精细的控制或以其他方式对其进行修改，请使用setChildProcessModifier() 函数。如果同时设置了子进程修饰符和 Unix 进程参数，则在应用这些参数之前会先执行该修饰符。

该函数在 Qt 6.6 中引入。

另请参阅 unixProcessParameters() 和setChildProcessModifier()。

[since 6.6] void QProcess::setUnixProcessParameters(QProcess::UnixProcessFlags flagsOnly)

在 Unix 系统上将子进程的额外设置设为flagsOnly 。这与仅设置了flags 字段的重载方法效果相同。

该函数在 Qt 6.6 中引入。

另请参见 unixProcessParameters() 和setChildProcessModifier()。

void QProcess::setWorkingDirectory(const QString &dir)

将工作目录设置为dir 。QProcess 将在该目录下启动进程。默认行为是在调用进程的工作目录下启动进程。

另请参阅 workingDirectory() 和start()。

[static] QStringList QProcess::splitCommand(QStringView command)

将字符串command 拆分为一个令牌列表，并返回该列表。

包含空格的词元可以用双引号括起来；三个连续的双引号表示引号字符本身。

void QProcess::start(const QString &program, const QStringList &arguments = {}, QIODeviceBase::OpenMode mode = ReadWrite)

在新的进程中启动指定的program ，并将arguments 中的命令行参数传递给该进程。有关QProcess 如何搜索待运行的可执行文件的详细信息，请参阅setProgram()。OpenMode被设置为mode 。不会对参数进行进一步拆分。

QProcess 对象将立即进入Starting状态。如果进程启动成功，QProcess 将发出started()信号；否则，将发出errorOccurred()信号。请注意，在能够同步启动子进程的平台上（特别是Windows），这些信号将在本函数返回之前发出，且该QProcess 对象将分别过渡到QProcess::Running 或QProcess::NotRunning 状态。 在其他平台上，started() 和errorOccurred() 信号会被延迟。

调用 `waitForStarted()` 可确保进程已启动（或启动失败），且这些信号已发出。即使已知进程的启动状态，调用该函数也是安全的，不过信号不会再次发出。

Windows：参数会被加引号，并组合成与CommandLineToArgvW() Windows 函数兼容的命令行。对于具有不同命令行引号要求的程序，您需要使用setNativeArguments()。一个不遵循CommandLineToArgvW() 规则的典型程序是 cmd.exe，因此所有批处理脚本也不遵循该规则。

如果QProcess 对象已经正在运行一个进程，控制台可能会显示一条警告，而现有进程将继续运行，不受影响。

另请参阅 processId()、started()、waitForStarted() 以及setNativeArguments()。

void QProcess::start(QIODeviceBase::OpenMode mode = ReadWrite)

使用由 `setArguments()` 设置的参数，启动由 `setProgram()` 设置的程序。OpenMode 被设置为 `mode`。

另请参阅 open()、setProgram() 和setArguments()。

[since 6.0] void QProcess::startCommand(const QString &command, QIODeviceBase::OpenMode mode = ReadWrite)

在新的进程中启动命令 `command `。OpenMode 设置为 `mode`。

command 是一个包含程序名及其参数的单一文本字符串。参数之间用一个或多个空格分隔。例如：

QProcess process;
process.startCommand("del /s *.txt");
// same as process.start("del", QStringList() << "/s" << "*.txt");
//...

包含空格的参数必须加引号，才能正确传递给新进程。例如：

QProcess process;
process.startCommand("dir \"My Documents\"");

command 字符串中的字面引号由三个引号表示。例如：

QProcess process;
process.startCommand("dir \"Epic 12\"\"\" Singles\"");

在将command 字符串拆分并去除引号后，该函数的行为与start()相同。

在某些操作系统上，系统 API 原生使用单个字符串将命令行参数传递给子进程（如 Windows），因此可能会出现无法通过QProcess 的可移植列表式 API 传递的命令行。在这些罕见情况下，您需要使用setProgram() 和setNativeArguments() 代替此函数。

该函数在 Qt 6.0 中引入。

另请参阅 splitCommand() 和start()。

bool QProcess::startDetached(qint64 *pid = nullptr)

在新的进程中启动由setProgram()设定的程序，并使用setArguments()设定的参数，随后与该进程脱离。成功时返回true ；否则返回false 。如果调用进程退出，脱离后的进程仍将继续运行，不受影响。

Unix：启动的进程将在其自己的会话中运行，并表现为守护进程。

该进程将在由setWorkingDirectory()设置的目录中启动。若workingDirectory()为空，则工作目录从调用进程继承。

如果函数执行成功，则 *pid 将被设置为已启动进程的进程标识符；否则，它将被设置为 -1。请注意，子进程可能会退出，且 PID 可能会在没有通知的情况下失效。此外，在子进程退出后，相同的 PID 可能会被回收并由一个完全不同的进程使用。 用户代码在使用该变量时应格外谨慎，特别是当打算通过操作系统手段强制终止该进程时。

startDetached() 仅支持以下属性设置器：

• setArguments()
• setCreateProcessArgumentsModifier()
• setNativeArguments()
• setProcessEnvironment()
• setProgram()
• setStandardErrorFile()
• setStandardInputFile()
• setStandardOutputFile()
• setProcessChannelMode(QProcess::MergedChannels)
• setStandardOutputProcess()
• setWorkingDirectory()

QProcess 对象的所有其他属性均被忽略。

另请参阅 start() 和startDetached(const QString &program, const QStringList &arguments, const QString &workingDirectory, qint64 *pid)。

[static] bool QProcess::startDetached(const QString &program, const QStringList &arguments = {}, const QString &workingDirectory = QString(), qint64 *pid = nullptr)

在新的进程中启动程序program ，并传入参数arguments ，随后与该进程脱离。成功时返回true ；否则返回false 。如果调用进程退出，脱离后的进程将继续运行，不受影响。

参数处理方式与相应的start() 重载函数完全一致。

进程将在目录workingDirectory 中启动。如果workingDirectory 为空，则工作目录将从调用进程继承而来。

如果函数成功，则 *pid 将被设置为已启动进程的进程标识符。

另请参阅 start()。

[private signal] void QProcess::started()

当进程启动时，QProcess 会发出此信号，且state()返回Running 。

QProcess::ProcessState QProcess::state() const

返回进程的当前状态。

另请参阅 stateChanged() 和error()。

[private signal] void QProcess::stateChanged(QProcess::ProcessState newState)

每当QProcess 的状态发生变化时，都会触发此信号。newState 参数表示QProcess 所变换后的状态。

[static] QStringList QProcess::systemEnvironment()

返回调用进程的环境，格式为键值对列表。示例：

QStringList environment = QProcess::systemEnvironment();
// environment = {"PATH=/usr/bin:/usr/local/bin",
//                "USER=greg", "HOME=/home/greg"}

该函数不会缓存系统环境。因此，如果调用了诸如 `setenv ` 或 `putenv ` 之类的低级 C 库函数，则可能获得环境的更新版本。

但请注意，重复调用此函数会重新生成环境变量列表，这是一项非平凡的操作。

另请参阅 QProcessEnvironment::systemEnvironment() 和setProcessEnvironment()。

[slot] void QProcess::terminate()

尝试终止该进程。

调用此函数并不一定会导致进程退出（系统会给进程机会，提示用户处理任何未保存的文件等）。

在 Windows 系统上，terminate() 会向进程的所有顶级窗口发送 WM_CLOSE 消息，然后向进程本身的主线程发送该消息。在 Unix 和 macOS 系统上，则会发送SIGTERM 信号。

在 Windows 上，那些未运行事件循环的控制台应用程序，或者其事件循环未处理 WM_CLOSE 消息的控制台应用程序，只能通过调用kill() 来终止。

另请参阅 kill()。

[noexcept, since 6.6] QProcess::UnixProcessParameters QProcess::unixProcessParameters() const

返回一个UnixProcessParameters 对象，该对象描述了在Unix系统上将应用于子进程的额外标志和设置。默认设置对应于通过默认构造方式创建的UnixProcessParameters 。

该函数于 Qt 6.6 中引入。

另请参阅 setUnixProcessParameters() 和childProcessModifier()。

[override virtual] bool QProcess::waitForBytesWritten(int msecs = 30000)

重写了：QIODevice::waitForBytesWritten （int msecs）。

bool QProcess::waitForFinished(int msecs = 30000)

阻塞直至进程完成且发出finished()信号，或者直到经过msecs 毫秒。

如果进程已完成，则返回true ；否则返回false （如果操作超时、发生错误，或者此QProcess 已结束）。

该函数可在无事件循环的情况下运行。这在编写非GUI应用程序以及在非GUI线程中执行I/O操作时非常有用。

如果 msecs 为 -1，则此函数不会超时。

另请参阅 finished()、waitForStarted()、waitForReadyRead() 以及waitForBytesWritten()。

[override virtual] bool QProcess::waitForReadyRead(int msecs = 30000)

重写了：QIODevice::waitForReadyRead （int msecs）。

bool QProcess::waitForStarted(int msecs = 30000)

阻塞直至进程启动且发出started()信号，或者直到经过msecs 毫秒。

如果进程启动成功，则返回true ；否则返回false （如果操作超时或发生错误）。如果在此函数调用之前进程已成功启动，则该函数立即返回。

该函数可在无事件循环的情况下运行。这在编写非GUI应用程序以及在非GUI线程中执行I/O操作时非常有用。

如果 msecs 为 -1，则该函数不会超时。

另请参阅 started()、waitForReadyRead()、waitForBytesWritten() 和waitForFinished()。

QString QProcess::workingDirectory() const

如果已为QProcess 指定了工作目录，则该函数将返回程序启动前QProcess 将进入的工作目录。否则（即未指定目录），则返回空字符串，此时QProcess 将改用应用程序的当前工作目录。

另请参阅 setWorkingDirectory()。