QJsonObject Class

成员函数文档

QJsonObject::QJsonObject()

构建一个空的 JSON 对象。

另请参阅 isEmpty()。

QJsonObject::QJsonObject(std::initializer_list<std::pair<QString, QJsonValue>> args)

创建一个从args 初始化列表初始化的QJsonObject实例。例如：

QJsonObject object
{
    {"property1", 1},
    {"property2", 2}
};

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

创建other 的副本。

由于 QJsonObject 是隐式共享的，只要该对象未被修改，则该副本为浅拷贝。

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

从 `other` 创建一个 `QJsonObject`。

[noexcept] QJsonObject::~QJsonObject()

销毁该对象。

返回一个范围对象，允许将该对象作为键值对进行迭代。例如，该范围对象可与结构化绑定声明结合使用，在基于范围的 for 循环中：

QJsonObject obj{
    {"something", "is"},
    {"in", "this"},
    {"object", 42},
};

for(auto [key,value]: obj.asKeyValueRange()) {
    qDebug() << key << "->" << value;
   if(key== "object")
        value= "!";// 修改该键对应的对象
}
qDebug() << obj["object"]; // QJsonValue(string, "!")

请注意，通过这种方式获得的值是对象中该值的引用。具体来说，修改该值将直接修改对象本身。

当在右值（例如在范围 for 循环的初始化器中创建的临时对象）上调用此方法时，该对象将被捕获到该范围内。

这些函数在 Qt 6.10 中引入。

另请参阅 QKeyValueIterator 。

QJsonObject::iterator QJsonObject::begin()

返回一个指向该对象中第一个元素的STL 风格迭代器。

另请参阅 constBegin() 和end()。

QJsonObject::const_iterator QJsonObject::begin() const

[since 6.12] QJsonObject::const_iterator QJsonObject::cbegin() const

返回一个指向该对象中第一个项的常量STL 风格迭代器。

该函数在 Qt 6.12 中引入。

另请参阅 begin() 和cend()。

[since 6.12] QJsonObject::const_iterator QJsonObject::cend() const

返回一个指向对象中最后一个项之后的虚拟项的常量STL 风格迭代器。

该函数在 Qt 6.12 中引入。

另请参阅 cbegin() 和end()。

QJsonObject::const_iterator QJsonObject::constBegin() const

返回一个指向该对象中第一个项的 constSTL 风格迭代器。

另请参阅 begin() 和constEnd()。

QJsonObject::const_iterator QJsonObject::constEnd() const

返回一个指向对象中最后一个项目之后的“虚拟”项目的常量STL 风格迭代器。

另请参阅 constBegin() 和end()。

QJsonObject::const_iterator QJsonObject::constFind(const QString &key) const

返回一个指向映射中键为key 的项的常量迭代器。

如果映射中不包含键为key 的项，则该函数返回constEnd()。

QJsonObject::const_iterator QJsonObject::constFind(QLatin1StringView key) const

QJsonObject::const_iterator QJsonObject::constFind(QStringView key) const

[since 6.10] QJsonObject::const_key_value_iterator QJsonObject::constKeyValueBegin() const

返回一个指向该对象中第一个条目的常量STL 风格迭代器。

该函数在 Qt 6.10 中引入。

另请参阅 keyValueBegin()。

[since 6.10] QJsonObject::const_key_value_iterator QJsonObject::constKeyValueEnd() const

返回一个指向对象中最后一个条目之后虚构条目的、STL 风格的const迭代器。

该函数在 Qt 6.10 中引入。

另请参阅 constKeyValueBegin()。

bool QJsonObject::contains(const QString &key) const

如果对象包含键key ，则返回true 。

另请参阅 insert()、remove() 和take()。

bool QJsonObject::contains(QLatin1StringView key) const

bool QJsonObject::contains(QStringView key) const

qsizetype QJsonObject::count() const

与size() 相同。

bool QJsonObject::empty() const

提供此函数是为了兼容 STL。它等同于 `isEmpty()`，如果对象为空，则返回 `true `；否则返回 `false`。

QJsonObject::iterator QJsonObject::end()

返回一个STL 风格的迭代器，该迭代器指向对象中最后一个元素之后的虚拟元素。

另请参阅 begin() 和constEnd()。

QJsonObject::const_iterator QJsonObject::end() const

QJsonObject::iterator QJsonObject::erase(QJsonObject::iterator it)

从映射中移除由迭代器it 所指向的 (键, 值) 对，并返回指向映射中下一个元素的迭代器。

另请参阅 remove()。

QJsonObject::iterator QJsonObject::find(const QString &key)

返回一个迭代器，该迭代器指向映射中键为key 的项。

如果映射中不存在键为key 的项，则该函数返回end()。

QJsonObject::iterator QJsonObject::find(QLatin1StringView key)

QJsonObject::iterator QJsonObject::find(QStringView key)

QJsonObject::const_iterator QJsonObject::find(QLatin1StringView key) const

QJsonObject::const_iterator QJsonObject::find(QStringView key) const

QJsonObject::const_iterator QJsonObject::find(const QString &key) const

[static] QJsonObject QJsonObject::fromVariantHash(const QVariantHash &hash)

将变体哈希hash 转换为QJsonObject 。

hash 中的键将作为 JSON 对象的键，而QVariant 中的值将被转换为 JSON 值。

另请参阅 fromVariantMap()、toVariantHash() 和QJsonValue::fromVariant()。

[static] QJsonObject QJsonObject::fromVariantMap(const QVariantMap &map)

将变体映射map 转换为QJsonObject 。

map 中的键将作为 JSON 对象的键，而QVariant 中的值将转换为 JSON 值。

另请参阅 fromVariantHash()、toVariantMap() 和QJsonValue::fromVariant()。

QJsonObject::iterator QJsonObject::insert(const QString &key, const QJsonValue &value)

插入一个新条目，其键为key ，值为value 。

如果已经存在键为key 的条目，则该条目的值将被替换为value 。

返回一个指向已插入项的迭代器。

如果值为QJsonValue::Undefined ，则会导致该键从对象中被移除。此时，返回的迭代器将指向end()。

另请参阅 remove()、take()、QJsonObject::iterator 以及end()。

QJsonObject::iterator QJsonObject::insert(QLatin1StringView key, const QJsonValue &value)

QJsonObject::iterator QJsonObject::insert(QStringView key, const QJsonValue &value)

bool QJsonObject::isEmpty() const

如果对象为空，则返回true 。这与size() == 0 效果相同。

另请参阅 size()。

[since 6.10] QJsonObject::key_value_iterator QJsonObject::keyValueBegin()

返回一个指向对象中第一个条目的STL 风格迭代器。

该函数在 Qt 6.10 中引入。

另请参阅 keyValueEnd()。

[since 6.10] QJsonObject::const_key_value_iterator QJsonObject::keyValueBegin() const

返回一个指向对象中第一个条目的常量STL 风格迭代器。

该函数在 Qt 6.10 中引入。

另请参阅 keyValueEnd()。

[since 6.10] QJsonObject::key_value_iterator QJsonObject::keyValueEnd()

返回一个STL 风格的迭代器，该迭代器指向对象中最后一个条目之后的虚拟条目。

该函数在 Qt 6.10 中引入。

另请参阅 keyValueBegin()。

[since 6.10] QJsonObject::const_key_value_iterator QJsonObject::keyValueEnd() const

返回一个指向对象中最后一个条目之后虚条目的、STL 风格的const迭代器。

该函数在 Qt 6.10 中引入。

另请参阅 keyValueBegin()。

QStringList QJsonObject::keys() const

返回该对象中所有键的列表。

该列表按字母顺序排序。

qsizetype QJsonObject::length() const

与size() 相同。

void QJsonObject::remove(const QString &key)

从对象中移除key 。

另请参阅 insert() 和take()。

void QJsonObject::remove(QLatin1StringView key)

void QJsonObject::remove(QStringView key)

qsizetype QJsonObject::size() const

返回对象中存储的 (键, 值) 对的数量。

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

将该对象与other 互换。此操作速度极快，且绝不会失败。

QJsonValue QJsonObject::take(const QString &key)

从对象中移除key 。

返回一个QJsonValue ，其中包含由key 所引用的值。如果对象中不包含key ，则返回的QJsonValue 为QJsonValue::Undefined 。

另请参阅 insert()、remove()，以及QJsonValue 。

QJsonValue QJsonObject::take(QLatin1StringView key)

QJsonValue QJsonObject::take(QStringView key)

QVariantHash QJsonObject::toVariantHash() const

将该对象转换为QVariantHash 。

返回生成的哈希。

另请参阅 toVariantMap()。

QVariantMap QJsonObject::toVariantMap() const

将该对象转换为QVariantMap 。

返回生成的映射。

另请参阅 toVariantHash()。

QJsonValue QJsonObject::value(const QString &key) const

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

如果该键不存在，则返回的 `QJsonValue ` 为 `QJsonValue::Undefined `。

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

QJsonValue QJsonObject::value(QLatin1StringView key) const

QJsonValue QJsonObject::value(QStringView key) const

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

将other 以“移动赋值”方式赋值给该对象。

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

将other 分配给此对象。

QJsonValueRef QJsonObject::operator[](const QString &key)

返回对 `key` 值的引用。如果对象中不存在键为 `key ` 的值，则会创建一个值为 `QJsonValue::Null ` 的键值对，并返回该值。

返回值的类型为QJsonValueRef ，这是QJsonArray 和QJsonObject 的辅助类。当您获取一个QJsonValueRef 类型的对象时，可以将其视为对QJsonValue 的引用。如果您对其进行赋值，该赋值将作用于您获取该引用的源对象（即QJsonArray 或QJsonObject ）中的元素。

另请参阅 value()。

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

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

这与value() 的效果相同。

如果该键不存在，则返回的 `QJsonValue ` 为 `QJsonValue::Undefined `。

另请参阅 value()、QJsonValue 以及QJsonValue::isUndefined()。

QJsonValueRef QJsonObject::operator[](QLatin1StringView key)

QJsonValueRef QJsonObject::operator[](QStringView key)

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

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