QJsonDocument Class

    {
        "Array": [
            true,
            999,
            "string"
        ],
        "Key": "Value",
        "null": null
    }

    {"Array":[true,999,"string"],"Key":"Value","null":null}

成员函数文档

QJsonDocument::QJsonDocument()

构建一个空的且无效的文档。

[explicit, since 6.12] QJsonDocument::QJsonDocument(QJsonArray &&array)

根据array 构建一个QJsonDocument。

该函数在 Qt 6.12 中引入。

[explicit, since 6.12] QJsonDocument::QJsonDocument(QJsonObject &&object)

根据object 创建一个QJsonDocument。

该函数在 Qt 6.12 中引入。

[explicit] QJsonDocument::QJsonDocument(const QJsonArray &array)

根据array 构建一个QJsonDocument。

[explicit] QJsonDocument::QJsonDocument(const QJsonObject &object)

根据object 创建一个QJsonDocument。

QJsonDocument::QJsonDocument(const QJsonDocument &other)

创建other 文档的副本。

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

从 `other` 动态构造一个 `QJsonDocument`。

[noexcept] QJsonDocument::~QJsonDocument()

删除文档。

通过 fromRawData 生成的二进制数据集不会被释放。

QJsonArray QJsonDocument::array() const

返回文档中包含的QJsonArray 。

如果文档中包含一个对象，则返回一个空数组。

另请参阅 isArray()、object() 和setArray()。

[static] QJsonDocument QJsonDocument::fromJson(const QByteArray &json, QJsonParseError *error = nullptr)

将 `json ` 作为 UTF-8 编码的 JSON 文档进行解析，并据此创建一个 `QJsonDocument `。

如果解析成功，则返回一个有效的（非空）QJsonDocument 。如果解析失败，返回的文档将为空，且可选的error 变量将包含有关错误的详细信息。

另请参阅 toJson()、QJsonParseError 以及isNull()。

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

根据QVariant variant 创建一个QJsonDocument 。

如果 `variant ` 包含除 `QVariantMap`、`QVariantHash`、`QVariantList ` 或 `QStringList` 以外的任何其他类型，则返回的文档将无效。

另请参阅 toVariant()。

bool QJsonDocument::isArray() const

如果文档包含一个数组，则返回true 。

另请参阅 array() 和isObject()。

bool QJsonDocument::isEmpty() const

如果文档中不包含任何数据，则返回true 。

bool QJsonDocument::isNull() const

如果该文档为空，则返回true 。

空文档是指通过默认构造函数创建的文档。

由 UTF-8 编码文本或二进制格式创建的文档将在解析过程中进行验证。如果验证失败，返回的文档也将为 null。

bool QJsonDocument::isObject() const

如果文档中包含一个对象，则返回true 。

另请参阅 object() 和isArray()。

QJsonObject QJsonDocument::object() const

返回文档中包含的QJsonObject 。

如果文档包含一个数组，则返回一个空对象。

另请参阅 isObject()、array() 和setObject()。

void QJsonDocument::setArray(const QJsonArray &array)

将array 设置为本文档的主对象。

另请参阅 setObject() 和array()。

void QJsonDocument::setObject(const QJsonObject &object)

将object 设置为本文档的主对象。

另请参阅 setArray() 和object()。

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

将此文档与other 互换。此操作非常快，且从不会失败。

QByteArray QJsonDocument::toJson(QJsonDocument::JsonFormat format = JsonFormat::Indented) const

将QJsonDocument 转换为UTF-8编码的JSON文档，并将其写入指定的format 中。

另请参阅 fromJson() 和JsonFormat 。

QVariant QJsonDocument::toVariant() const

返回一个表示 JSON 文档的 `QVariant `。

如果文档是QJsonArray ，则返回的变体为QVariantList ；如果文档是QJsonObject ，则返回的变体为QVariantMap 。

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

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

将other 移动并分配到此文档中。

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

将other 文档分配给此QJsonDocument 。返回对此对象的引用。

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

返回一个表示键key 的值的QJsonValue 对象。

等同于调用object().value(key)。

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

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

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

返回一个表示索引i 所对应值的 `QJsonValue `。

等同于调用array().at(i)。

若i 超出范围，或isArray()返回false，则返回的QJsonValue 即为QJsonValue::Undefined 。

另请参阅 QJsonValue 、QJsonValue::isUndefined() 和QJsonArray 。

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

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