QProcessEnvironment Class

Dokumentation der Mitgliedsfunktionen

QProcessEnvironment::QProcessEnvironment()

Erstellt ein neues `QProcessEnvironment`-Objekt. Dieser Konstruktor erstellt eine leere Umgebung. Wird dieser Konstruktor auf eine bereits vorhandene Umgebung (` QProcess`) angewendet, werden die aktuellen Umgebungsvariablen entfernt (mit Ausnahme von `PATH` und `SystemRoot` unter Windows).

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

Erstellt ein Objekt, das, wenn es unter QProcess festgelegt wird, dazu führt, dass es mit den vom übergeordneten Prozess geerbten Umgebungsvariablen ausgeführt wird.

Wenn eine modifizierte Version der übergeordneten Umgebung gewünscht wird, beginnen Sie mit dem Rückgabewert von ` systemEnvironment() ` und passen Sie diesen an (beachten Sie jedoch, dass Änderungen an der Umgebung des Elternprozesses, die nach deren Erstellung vorgenommen werden, nicht in der modifizierten Umgebung berücksichtigt werden).

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch ` inheritsFromParent()` und ` systemEnvironment()`.

QProcessEnvironment::QProcessEnvironment(const QProcessEnvironment &other)

Erstellt ein `QProcessEnvironment`-Objekt, das eine Kopie von ` other` ist.

[noexcept] QProcessEnvironment::~QProcessEnvironment()

Gibt die mit diesem „ QProcessEnvironment “-Objekt verknüpften Ressourcen frei.

void QProcessEnvironment::clear()

Entfernt alle Schlüssel-Wert-Paare aus diesem „ QProcessEnvironment “-Objekt, sodass es leer wird.

Wenn die Umgebung mit ` QProcessEnvironment::InheritFromParent ` erstellt wurde, bleibt sie unverändert.

Siehe auch „ isEmpty()“ und „ systemEnvironment()“.

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

Gibt „ true “ zurück, wenn die Umgebungsvariable mit dem Namen „ name “ in diesem „ QProcessEnvironment “-Objekt gefunden wird.

Siehe auch insert() und value().

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

Gibt „ true “ zurück, wenn dieses „ QProcessEnvironment “ mit „ QProcessEnvironment::InheritFromParent “ erstellt wurde.

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch isEmpty().

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

Fügt die Umgebungsvariable mit dem Namen „ name “ und dem Inhalt „ value “ in dieses „ QProcessEnvironment “-Objekt ein. Falls diese Variable bereits existierte, wird sie durch den neuen Wert ersetzt.

Auf den meisten Systemen hat das Einfügen einer Variablen ohne Inhalt für Anwendungen denselben Effekt, als wäre die Variable gar nicht gesetzt worden. Um jedoch sicherzustellen, dass keine Inkompatibilitäten auftreten, verwenden Sie zum Entfernen einer Variablen bitte die Funktion ` remove()`.

Siehe auch contains(), remove() und value().

void QProcessEnvironment::insert(const QProcessEnvironment &e)

Fügt den Inhalt von „ e “ in dieses „ QProcessEnvironment “-Objekt ein. Variablen in diesem Objekt, die auch in „ e “ vorhanden sind, werden überschrieben.

bool QProcessEnvironment::isEmpty() const

Gibt „ true “ zurück, wenn dieses „ QProcessEnvironment “-Objekt leer ist, d. h. wenn keine Schlüssel-Wert-Paare festgelegt sind.

Diese Methode gibt auch „ true “ für Objekte zurück, die mit „ QProcessEnvironment::InheritFromParent “ erstellt wurden.

Siehe auch clear(), systemEnvironment(), insert() und inheritsFromParent().

QStringList QProcessEnvironment::keys() const

Gibt eine Liste zurück, die alle Variablennamen in diesem QProcessEnvironment -Objekt enthält.

Bei Objekten, die mit „ QProcessEnvironment::InheritFromParent “ erstellt wurden, ist die zurückgegebene Liste leer.

void QProcessEnvironment::remove(const QString &name)

Entfernt die durch name identifizierte Umgebungsvariable aus diesem QProcessEnvironment -Objekt. Falls diese Variable zuvor nicht existierte, geschieht nichts.

Siehe auch „ contains()“, „ insert()“ und „ value()“.

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

Ersetzt diese Instanz der Prozessumgebung durch „ other “. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

[static] QProcessEnvironment QProcessEnvironment::systemEnvironment()

Die Funktion `systemEnvironment` gibt die Umgebungsvariablen des aufrufenden Prozesses zurück.

Sie wird als ` QProcessEnvironment` zurückgegeben. Diese Funktion speichert die Systemumgebung nicht im Cache. Daher ist es möglich, eine aktualisierte Version der Umgebung zu erhalten, wenn Low-Level-Funktionen der C-Bibliothek wie ` setenv ` oder ` putenv ` aufgerufen wurden.

Beachten Sie jedoch, dass wiederholte Aufrufe dieser Funktion das ` QProcessEnvironment `-Objekt neu erstellen, was einen nicht unerheblichen Aufwand darstellt.

Siehe auch QProcess::systemEnvironment().

QStringList QProcessEnvironment::toStringList() const

Wandelt dieses „ QProcessEnvironment “-Objekt in eine Liste von Zeichenketten um, wobei für jede gesetzte Umgebungsvariable eine Zeichenkette entsteht. Der Name der Umgebungsvariablen und ihr Wert werden durch ein Gleichheitszeichen („=“) getrennt.

Der von dieser Funktion zurückgegebene Inhalt des ` QStringList ` ist für die Darstellung geeignet. Die Verwendung mit der Funktion `QProcess::setEnvironment` wird aufgrund möglicher Kodierungsprobleme unter Unix und einer schlechteren Leistung nicht empfohlen.

Siehe auch ` systemEnvironment()`, ` QProcess::systemEnvironment()` und ` QProcess::setProcessEnvironment()`.

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

Durchsucht dieses QProcessEnvironment -Objekt nach einer Variable mit der Kennung name und gibt deren Wert zurück. Wird die Variable in diesem Objekt nicht gefunden, wird stattdessen defaultValue zurückgegeben.

Siehe auch contains(), insert() und remove().

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

Kopiert den Inhalt des Objekts „ other “ ( QProcessEnvironment ) in dieses Objekt.