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()は「子プロセス修飾子がエラーを報告しました: 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）を再実装します。

setProgram() で設定されたプログラムを、setArguments() で設定された引数とともに起動します。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 から切断したりすることなど）は、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 を設定します。

サブプロセスにコマンドライン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() を参照してください。

注：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 プロセスの標準入力にパイプで送ります。

次のシェルコマンド：

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 ` をトークンのリストに分割し、そのリストを返します。

スペースを含むトークンは二重引用符で囲むことができます。3つの連続した二重引用符は、引用符そのものを表します。

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:引数は引用符で囲まれ、Windows のCommandLineToArgvW() 関数と互換性のあるコマンドラインに結合されます。コマンドラインの引用符の扱いに関する要件が異なるプログラムの場合は、setNativeArguments() を使用する必要があります。CommandLineToArgvW() のルールに従わない代表的なプログラムとして cmd.exe が挙げられ、その結果、すべてのバッチスクリプトも同様です。

QProcess オブジェクトがすでにプロセスを実行している場合、コンソールに警告が表示されることがありますが、既存のプロセスは影響を受けずに実行を継続します。

関連項目： processId()、started()、waitForStarted()、およびsetNativeArguments()。

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

setProgram() で指定されたプログラムを、setArguments() で指定された引数とともに起動します。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)

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)

引数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()

呼び出し元のプロセスの環境を、キー=値のペアのリストとして返します。例：

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

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()も参照してください 。