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 = {})

引数arguments を持つプログラムprogram を新しいプロセスで開始し、終了するまで待ち、プロセスの終了コードを返す。新しいプロセスがコンソールに書き込んだデータは、呼び出し元のプロセスに転送される。

環境と作業ディレクトリは、呼び出し元のプロセスから継承される。

引数の扱いは、それぞれの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 は親プロセスでコードQProcess::FailedToStart を持つerrorOccurred() を発行します。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() は "Child process modifier reported error: aux comm channel：不正なファイル記述子" となる。

この関数は呼び出し元には戻りません。子プロセス・モディファイアと正しい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 mode).

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)

Unixシステム(macOSを含む。Windowsの場合はsetCreateProcessArgumentsModifier()を参照)の場合、子プロセスのmodifier 関数を設定する。modifier 引数に指定された関数は、fork() またはvfork() が完了し、QProcess が子プロセスの標準ファイル記述子をセットアップした後、execve() より前に、start() 内で呼び出される。

以下に、子プロセスを特権なしで実行するように設定する例を示す：

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 との接続を切断したりといった子プロセスの特定のプロパティは、失敗を検出してFailedToStart 状態を報告するsetUnixProcessParameters() を使用することで、より容易に実現できます。この修飾子は、追加のファイル記述子を設定するなど、子プロセスの特定の一般的でないプロパティを変更するのに便利である。子プロセス修飾子と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 を設定する。

サブプロセスにコマンドラインarguments を渡すためのシステムAPIがネイティブに単一の文字列を使用するオペレーティングシステムでは、QProcess のポータブルリストベースのAPIでは渡せないコマンドラインが考えられる。そのような場合、この関数を使用して、通常の引数リストから構成される文字列に、区切りスペースを追加した文字列を設定しなければならない。

nativeArguments()も参照のこと 。

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

QProcess 標準出力および標準エラー・チャネルのチャネル・モードを、指定されたmode に設定する。このモードは、次にstart() が呼び出されたときに使用される。例えば

QProcessbuilder; builder.setProcessChannelMode(QProcess::MergedChannels); builder.start("make"、 QStringList()<< "-j2");if(!builder.waitForFinished())    qDebug() << "Make failed:" << builder.errorString();
その他    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() を参照のこと。

注意：QProcess::MergedChannels を引数としてsetProcessChannelMode() が呼び出された場合、この関数は無効である。

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 プロセスの標準入力にパイプする。

以下のシェル・コマンド：

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 に子プロセスの修正を依頼するために使用できる。

この関数を使用すると、余計なファイル記述子をすべて閉じたり、子プロセスのナイス・レベルを変更したり、制御している 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 をトークンのリストに分割し、そのリストを返す。

空白を含むトークンは二重引用符で囲むことができます。連続する3つの二重引用符は引用符文字そのものを表します。

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

指定されたprogram を新しいプロセスで起動し、arguments でコマンドライン引数を渡す。QProcess が実行する実行ファイルを検索する方法については、setProgram() を参照のこと。mode引数の分割は行われません。

QProcess オブジェクトは直ちに Starting 状態に入る。errorOccurredプロセスが正常に開始すると、QProcess からstarted() が発行される。同期的に子プロセスを開始できるプラットフォーム（特にWindows）では、この関数が戻る前にこれらのシグナルが発せられ、このQProcess オブジェクトはそれぞれQProcess::Running またはQProcess::NotRunning 状態に遷移することに注意してください。その他の形式では、started() およびerrorOccurred() シグナルは遅延する。

waitForStarted() を呼び出して、プロセスが開始し（または開始できなかった）、これらのシグナルが発せられたことを確認する。プロセスの開始状態が既知であっても、この関数を呼び出すことは安全である。

Windowsの場合：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 は、プログラム名と引数の両方を含む単一の文字列である。引数は 1 つ以上のスペースで区切られる。例えば

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)

setArguments() によって設定された引数でsetProgram() によって設定されたプログラムを新しいプロセスで起動し、そのプロセスから切り離す。成功した場合は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)

この関数はstartDetached()をオーバーロードする。

引数arguments を持つプログラムprogram を新しいプロセスで起動し、デタッチする。成功した場合は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()

呼び出し元のプロセスの環境を key=value ペアのリストとして返します。例

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 シグナルが送信される。

イベント・ループを実行しない、またはイベント・ループがWM_CLOSEメッセージを処理しないWindows上のコンソール・アプリケーションは、kill （）を呼び出すことによってのみ終了させることができる。

kill()も参照のこと 。

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

Unix システムで子プロセスに適用される追加フラグと設定を記述したUnixProcessParameters オブジェクトを返す。デフォルトの設定は、デフォルトで構築された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()も参照 。