QJsonDocument Class

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

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

成员函数文档

QJsonDocument::QJsonDocument()

构造一个空的无效文档。

[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)

Move-从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 编码文本或二进制格式创建的文档会在解析过程中进行验证。如果验证失败，返回的文档也将为空。

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

在提供的format 中将QJsonDocument 转换为 UTF-8 编码的 JSON 文档。

另请参阅 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

这是一个重载函数。