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 オブジェクトからすべてのキー=値のペアを削除し、空の状態にします。

環境が `QProcessEnvironment::InheritFromParent ` を使用して構築された場合、その環境は変更されません。

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

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

このQProcessEnvironment オブジェクト内に、名前がname である環境変数が存在する場合、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)

e の内容を、このQProcessEnvironment オブジェクトに挿入します。このオブジェクトに含まれ、かつ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)

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

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 の内容は、そのまま表示に適しています。Unix環境下ではエンコーディングの問題が発生する可能性があり、パフォーマンスも低下するため、QProcess::setEnvironment関数との併用は推奨されません。

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 オブジェクトの内容を、このオブジェクトにコピーします。