QJsonValue Class

成员函数文档

QJsonValue::QJsonValue(QJsonValue::Type type = Null)

创建type 类型的 QJsonValue。

默认创建一个空值。

QJsonValue::QJsonValue(QLatin1StringView s)

创建一个字符串类型的值，其中的 Latin-1 字符串由s 查看。

QJsonValue::QJsonValue(bool b)

创建一个 Bool 类型的值，值为b 。

QJsonValue::QJsonValue(const QJsonArray &a)

创建数组类型的值，值为a 。

QJsonValue::QJsonValue(const QJsonObject &o)

创建对象类型的值，值为o 。

QJsonValue::QJsonValue(const QString &s)

创建字符串类型的值，值为s 。

QJsonValue::QJsonValue(const char *s)

创建一个字符串类型的值，其值为s ，假设输入为 UTF-8 编码。

您可以在编译应用程序时通过定义QT_NO_CAST_FROM_ASCII 禁用该构造函数。

QJsonValue::QJsonValue(double v)

创建一个 Double 类型的值，值为v 。

[noexcept, since 6.3] QJsonValue::QJsonValue(QJsonArray &&a)

这是一个重载函数。

该函数在 Qt 6.3 中引入。

[noexcept, since 6.3] QJsonValue::QJsonValue(QJsonObject &&o)

这是一个重载函数。

该函数在 Qt 6.3 中引入。

QJsonValue::QJsonValue(int v)

这是一个重载函数。

创建一个 Double 类型的值，值为v 。

QJsonValue::QJsonValue(qint64 v)

这是一个重载函数。

创建值为v 的 Double 类型值。注意：IEEE 754 双精度数据的整数限制为 2^53（-9007199254740992 至 +9007199254740992）。如果您输入的值超出了这个范围，就会出现精度损失。

[noexcept] QJsonValue::QJsonValue(const QJsonValue &other)

创建other 的副本。

[noexcept] QJsonValue::QJsonValue(QJsonValue &&other)

移动-从other 构建一个 QJsonValue。

[noexcept] QJsonValue::~QJsonValue()

破坏值。

[static, since 6.9] QJsonValue QJsonValue::fromJson(QByteArrayView json, QJsonParseError *error = nullptr)

将json 解析为 UTF-8 编码的 JSON 值，并从中创建QJsonValue 。

如果解析成功，则返回有效的QJsonValue 。如果解析失败，返回值将是undefined ，可选的error 变量将包含有关错误的更多详细信息。

此函数在 Qt 6.9 中引入。

另请参阅 QJsonParseError 、isUndefined() 和toJson()。

[static] QJsonValue QJsonValue::fromVariant(const QVariant &variant)

将variant 转换为QJsonValue 并返回。

转换将按如下方式转换QVariant 类型：

信息丢失和其他类型

QVariant QJsonValue::Map 可以携带比 JSON 所能表示的更多的信息。如果 不是上述类型之一，则不能保证进行转换，并且在 Qt XML 的未来版本中可能会发生变化，就像 UUID 的变化一样。代码应尽量不使用上述类型以外的其他类型。QVariant

如果QVariant::isNull() 返回 true，则返回一个空QJsonValue 或插入到列表或对象中，而不管QVariant 所携带的类型是什么。请注意 Qt XML 6.0 中影响QVariant::isNull() 的行为变化也会影响此函数。

无穷大或 NaN 的浮点数值将被转换为 JSON 空值。自 Qt 6.0 起，QJsonValue 可以无损地存储任何 64 位有符号整数的全部精度，但在以前的版本中，超出 ±2^53 范围的值可能会丢失精度。大于或等于 2^63 的 64 位无符号数值要么会丢失精度，要么会别名为负值，因此应避免使用QMetaType::ULongLong 。

对于上面未列出的其他类型，将尝试转换为字符串，通常但不总是调用QVariant::toString() 。如果转换失败，该值将被空 JSON 值取代。请注意，对于大多数类型，QVariant::toString() 也是有损的。例如，如果传递的QVariant 表示原始字节数组数据，建议将其预编码为Base64（或其他无损编码），否则将使用QString::fromUtf8() 进行有损转换。

请注意，通过QVariant::toString() 进行的转换可能会随时更改。QVariant 和QJsonValue 今后可能会扩展以支持更多类型，这将导致该函数执行转换的方式发生变化。

另请参阅 toVariant() 和QCborValue::fromVariant()。

bool QJsonValue::isArray() const

如果值包含数组，则返回true 。

另请参见 toArray()。

bool QJsonValue::isBool() const

如果值包含布尔值，则返回true 。

另请参见 toBool()。

bool QJsonValue::isDouble() const

如果数值包含 double，则返回true 。

另请参见 toDouble().

bool QJsonValue::isNull() const

如果值为空，则返回true 。

bool QJsonValue::isObject() const

如果值包含一个对象，则返回true 。

另请参见 toObject()。

bool QJsonValue::isString() const

如果值包含字符串，则返回true 。

另请参阅 toString()。

bool QJsonValue::isUndefined() const

如果值未定义，则返回true 。这可能发生在某些错误情况下，例如访问QJsonObject 中不存在的键。

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

将此值与other 互换。该操作速度非常快，从未出现过故障。

QJsonArray QJsonValue::toArray(const QJsonArray &defaultValue) const

将数值转换为数组并返回。

如果type() 不是数组，则会返回defaultValue 。

QJsonArray QJsonValue::toArray() const

这是一个重载函数。

将值转换为数组并返回。

如果type() 不是 Array，则将返回QJsonArray()。

bool QJsonValue::toBool(bool defaultValue = false) const

将值转换为 bool 并返回。

如果type() 不是 bool，则会返回defaultValue 。

double QJsonValue::toDouble(double defaultValue = 0) const

将数值转换为 double 并返回。

如果type() 不是 Double，则会返回defaultValue 。

int QJsonValue::toInt(int defaultValue = 0) const

将数值转换为 int 并返回。

如果type() 不是 Double 或值不是整数，则将返回defaultValue 。

[since 6.0] qint64 QJsonValue::toInteger(qint64 defaultValue = 0) const

将数值转换为整数并返回。

如果type() 不是 Double 或值不是可表示为 qint64 的整数，则将返回defaultValue 。

此函数在 Qt 6.0 中引入。

[since 6.9] QByteArray QJsonValue::toJson(QJsonValue::JsonFormat format = JsonFormat::Indented) const

在提供的format 中将QJsonValue 转换为 UTF-8 编码的 JSON 值。

此函数在 Qt 6.9 中引入。

另请参阅 fromJson() 和JsonFormat 。

QJsonObject QJsonValue::toObject(const QJsonObject &defaultValue) const

将数值转换为对象并返回。

如果type() 不是 Object，则将返回defaultValue 。

QJsonObject QJsonValue::toObject() const

这是一个重载函数。

将数值转换为对象并返回。

如果type() 不是 Object，则将返回QJsonObject()。

QString QJsonValue::toString() const

将值转换为QString 并返回。

如果type() 不是字符串，则将返回空QString 。

另请参阅 QString::isNull()。

QString QJsonValue::toString(const QString &defaultValue) const

将值转换为QString 并返回。

如果type() 不是字符串，则将返回defaultValue 。

QVariant QJsonValue::toVariant() const

将数值转换为QVariant() 。

QJsonValue 类型的转换如下：

另请参见 fromVariant()。

QJsonValue::Type QJsonValue::type() const

返回值的类型。

另请参见 QJsonValue::Type 。

[noexcept] QJsonValue &QJsonValue::operator=(QJsonValue &&other)

移动--将other 指定为该值。

[noexcept] QJsonValue &QJsonValue::operator=(const QJsonValue &other)

将other 中存储的值赋值给此对象。

const QJsonValue QJsonValue::operator[](const QString &key) const

返回代表键key 值的QJsonValue 。

相当于调用toObject().value(key) 。

如果键不存在，或isObject() 为 false，则返回的QJsonValue 为QJsonValue::Undefined 。

另请参阅 QJsonValue,QJsonValue::isUndefined() 和QJsonObject 。

const QJsonValue QJsonValue::operator[](qsizetype i) const

返回代表索引i 值的QJsonValue 。

相当于调用toArray().at(i) 。

如果i 越界，或isArray() 为 false，则返回的QJsonValue 为QJsonValue::Undefined 。

另请参见 QJsonValue,QJsonValue::isUndefined() 和QJsonArray 。

const QJsonValue QJsonValue::operator[](QLatin1StringView key) const

这是一个重载函数。

const QJsonValue QJsonValue::operator[](QStringView key) const

这是一个重载函数。