QProcessEnvironment 类

成员函数文档

QProcessEnvironment::QProcessEnvironment()

创建一个新的 QProcessEnvironment 对象。此构造函数创建一个空环境。如果将此对象设置为 QProcess，则将导致当前环境变量被删除（Windows 上的 PATH 和 SystemRoot 除外）。

[noexcept，自 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()。

[自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 对象中。此对象中也存在的变量将被覆盖。

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。此函数执行非常快，永远不会失败。

[静态] QProcessEnvironment QProcessEnvironment::systemEnvironment()

systemEnvironment 函数返回调用进程的环境。

它作为 QProcessEnvironment 返回。此函数不缓存系统环境。因此，如果已调用低级 C 库函数如 setenv 或 putenv，则可以获取环境的更新版本。

但是，请注意，对这一函数的重复调用将重新创建 QProcessEnvironment 对象，这是一个非 routine 的操作。

参见QProcess::systemEnvironment。

QStringList QProcessEnvironment::toStringList() const

将此 QProcessEnvironment 对象转换为字符串列表，每个环境变量的名称和一个等于字符（'='）分隔其值。

此函数返回的 QStringList 内容适合于展示。由于潜在的编码问题和较差的性能，不建议与 QProcess::setEnvironment 函数一起使用。

参见systemEnvironment，QProcess::systemEnvironment 和 QProcess::setProcessEnvironment。

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

在此 QProcessEnvironment 对象中搜索由 name 标识的变量，并返回其值。如果在此对象中找不到该变量，则返回 defaultValue 而不是值。

参见contains，insert 和 remove。

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

如果此对象与 other 对象不同，则返回 true。

参见operator==。

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

将 other 对象的内容复制到当前对象中。

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

如果此对象与 other 对象相等，则返回 true。

如果有相同的键=值对集合，认为两个 QProcessEnvironment 对象是相等的。在环境区分大小写的平台上，按大小写敏感的方式比较键。

另请参阅 operator!=() 和 contains()。