QProcessEnvironment Class

メンバ関数の説明

QProcessEnvironment::QProcessEnvironment()

新しい QProcessEnvironment オブジェクトを作成します。このコンストラクタは空の環境を作成します。QProcess に設定すると、現在の環境変数が削除されます (Windows の PATH と SystemRoot を除く)。

[noexcept, since 6.3] QProcessEnvironment::QProcessEnvironment(QProcessEnvironment::Initialization)

QProcess に設定すると、親プロセスから環境変数を継承して実行されるオブジェクトを作成する。

親プロセスの環境を変更したい場合は、systemEnvironment() の戻り値から開始し、それを変更します（ただし、作成後に親プロセスの環境を変更しても、変更後の環境には反映されないことに注意してください）。

この関数は Qt 6.3 で導入されました。

inheritsFromParent() およびsystemEnvironment()も参照してください 。

QProcessEnvironment::QProcessEnvironment(const QProcessEnvironment &other)

other のコピーである QProcessEnvironment オブジェクトを作成します。

[noexcept] QProcessEnvironment::~QProcessEnvironment()

このQProcessEnvironment オブジェクトに関連付けられているリソースを解放します。

void QProcessEnvironment::clear()

このQProcessEnvironment オブジェクトからすべての key=value ペアを削除し、空にする。

この環境がQProcessEnvironment::InheritFromParent を使って構築されたものである場合、それは変更されません。

isEmpty() およびsystemEnvironment()も参照 。

bool QProcessEnvironment::contains(const QString &name) const

name という名前の環境変数がこのQProcessEnvironment オブジェクトで見つかった場合、true を返す。

insert() およびvalue()も参照 。

[since 6.3] bool QProcessEnvironment::inheritsFromParent() const

このQProcessEnvironment がQProcessEnvironment::InheritFromParent を使って構築された場合はtrue を返す。

この関数は Qt 6.3 で導入されました。

isEmpty()も参照してください 。

void QProcessEnvironment::insert(const QString &name, const QString &value)

名前name 、内容value の環境変数をこのQProcessEnvironment オブジェクトに挿入する。その変数がすでに存在する場合は、新しい値で置き換えられる。

ほとんどのシステムでは、内容のない変数を挿入しても、アプリケーションにとっては、変数がまったく設定されていないのと同じ効果があります。しかし、非互換性がないことを保証するために、変数を削除するにはremove() 関数を使用してください。

contains(),remove(),value()も 参照のこと。

void QProcessEnvironment::insert(const QProcessEnvironment &e)

これはオーバーロードされた関数である。

QProcessEnvironment オブジェクトにe の内容を挿入します。e にも存在するこのオブジェクトの変数は上書きされます。

bool QProcessEnvironment::isEmpty() const

QProcessEnvironment オブジェクトが空の場合、true を返す。

このメソッドは、QProcessEnvironment::InheritFromParent を使用して構築されたオブジェクトについてもtrue を返します。

clear()、systemEnvironment()、insert() およびinheritsFromParent()も参照 。

QStringList QProcessEnvironment::keys() const

このQProcessEnvironment オブジェクトのすべての変数名を含むリストを返す。

QProcessEnvironment::InheritFromParent を使用して構築されたオブジェクトでは、返されるリストは空です。

void QProcessEnvironment::remove(const QString &name)

QProcessEnvironment オブジェクトからname で指定された環境変数を削除する。その変数が存在しない場合は、何も起こりません。

contains()、insert()、value()も参照 。

[noexcept] void QProcessEnvironment::swap(QProcessEnvironment &other)

このプロセス環境インスタンスをother と交換する。この操作は非常に高速で、失敗することはない。

[static] QProcessEnvironment QProcessEnvironment::systemEnvironment()

systemEnvironment関数は、呼び出し元のプロセスの環境を返す。

QProcessEnvironmentこの関数はシステム環境をキャッシュしない。したがって、setenv やputenv のような低レベルの C ライブラリ関数が呼び出された場合、環境の更新バージョンを取得することが可能です。

ただし、この関数を繰り返し呼び出すと、QProcessEnvironment オブジェクトが再作成され、これは自明な操作ではないことに注意。

QProcess::systemEnvironment()も参照のこと 。

QStringList QProcessEnvironment::toStringList() const

このQProcessEnvironment オブジェクトを、設定されている環境変数ごとに1つずつ、文字列のリストに変換します。環境変数の名前とその値は等号（'='）で区切られる。

この関数が返すQStringList の内容は、プレゼンテーションに適しています。QProcess::setEnvironment関数との併用は、Unix環境ではエンコーディングの問題が発生する可能性があり、パフォーマンスも低下するため推奨されません。

systemEnvironment(),QProcess::systemEnvironment(),QProcess::setProcessEnvironment()も参照 。

QString QProcessEnvironment::value(const QString &name, const QString &defaultValue = QString()) const

このQProcessEnvironment オブジェクトからname で指定された変数を検索し、その値を返す。その変数がこのオブジェクトに見つからない場合は、代わりにdefaultValue が返される。

contains()、insert()、remove()も参照のこと 。

QProcessEnvironment &QProcessEnvironment::operator=(const QProcessEnvironment &other)

other QProcessEnvironment オブジェクトの内容をこのオブジェクトにコピーする。