<Qt环境变量> 代理页面

函数文档

这些函数返回环境变量 varName 的值，作为一个 QString 对象。如果环境中找不到变量 varName 并且提供了 defaultValue，则返回 defaultValue。否则返回 QString()。

Qt 环境操作函数是线程安全的，但这要求不直接调用 C 库等效函数，如 getenv 和 putenv。

以下表格描述了在 qgetenv() 和 qEnvironmentVariable() 之间进行选择的方法

另请参阅 qputenv()，qgetenv()，qEnvironmentVariableIsSet()，和 qEnvironmentVariableIsEmpty()。

QString qEnvironmentVariable(const char *varName, const QString &defaultValue)

QString qEnvironmentVariable(const char *varName)

[noexcept] int qEnvironmentVariableIntValue(const char *varName, bool *ok = nullptr)

返回环境变量 varName 的数值。如果 ok 不是空指针，根据转换的成功与否，将 *ok 设置为 true 或 false。

等同于

    qgetenv(varName).toInt(ok, 0)

但速度更快，且不能抛出异常。

另请参阅 qgetenv()，qEnvironmentVariable()，和 qEnvironmentVariableIsSet()。

[noexcept] bool qEnvironmentVariableIsEmpty(const char *varName)

返回环境变量 varName 是否为空。

等同于

    qgetenv(varName).isEmpty()

但可能更快，且不能抛出异常。

另请参阅 qgetenv()，qEnvironmentVariable()，和 qEnvironmentVariableIsSet()。

[noexcept] bool qEnvironmentVariableIsSet(const char *varName)

返回环境变量 varName 是否被设置。

等同于

    !qgetenv(varName).isNull()

但可能更快，且不能抛出异常。

另请参阅 qgetenv()，qEnvironmentVariable()，和 qEnvironmentVariableIsEmpty()。

QByteArray qgetenv(const char *varName)

以 QByteArray 形式返回名为 varName 的环境变量的值。如果在环境中找不到该名称的变量，则此函数返回默认构造的 QByteArray。

Qt 环境操作函数是线程安全的，但这要求不直接调用 C 库等效函数，如 getenv 和 putenv。

要将数据转换为 QString，请使用 QString::fromLocal8Bit。

注意： 此函数是 线程安全 的。

另请参阅 qputenv()，qEnvironmentVariable()，qEnvironmentVariableIsSet()，和 qEnvironmentVariableIsEmpty()。

bool qputenv(const char *varName, QByteArrayView value)

此函数设置名为 varName 的环境变量的 value。如果该变量不存在，则创建该变量。如果无法设置变量，则返回 0。

使用空值调用qputenv在Windows上会删除环境变量，并在Unix上设置（但为空）。建议使用qunsetenv()以实现完全可移植的行为。

另请参阅：qgetenv()和qEnvironmentVariable。

bool qunsetenv(const char *varName)

此函数从环境变量中删除变量varName。

在成功时返回true。

另请参阅：qputenv()、qgetenv()以及qEnvironmentVariable。