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)

setCreateProcessArgumentsModifier子プロセスのmodifier 関数を設定する。Unix システムの場合（macOS を含む）。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() を呼び出したときに使用される。例えば

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() を参照のこと。

注意：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 が QIODevice::Truncate の場合、ファイルは切り捨てられる。そうでない場合（mode が QIODevice::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() を参照のこと。OpenMode は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()も参照してください 。