QJsonObject Class
Die Klasse QJsonObject kapselt ein JSON-Objekt. Mehr...
Kopfzeile: | #include <QJsonObject> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
qmake: | QT += core |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QJsonObject ist Teil von JSON Support in Qt und Implicitly Shared Classes.
Diese Klasse ist gleichsetzbar.
Diese Klasse ist gleichwertig mit QJsonValue und QJsonValueConstRef.
Hinweis: Alle Funktionen in dieser Klasse sind reentrant.
Öffentliche Typen
class | const_iterator |
class | iterator |
ConstIterator | |
Iterator | |
key_type | |
mapped_type | |
size_type |
Öffentliche Funktionen
QJsonObject() | |
QJsonObject(std::initializer_list<std::pair<QString, QJsonValue>> args) | |
QJsonObject(const QJsonObject &other) | |
QJsonObject(QJsonObject &&other) | |
~QJsonObject() | |
QJsonObject::iterator | begin() |
QJsonObject::const_iterator | begin() const |
QJsonObject::const_iterator | constBegin() const |
QJsonObject::const_iterator | constEnd() const |
QJsonObject::const_iterator | constFind(const QString &key) const |
QJsonObject::const_iterator | constFind(QLatin1StringView key) const |
QJsonObject::const_iterator | constFind(QStringView key) const |
bool | contains(const QString &key) const |
bool | contains(QLatin1StringView key) const |
bool | contains(QStringView key) const |
qsizetype | count() const |
bool | empty() const |
QJsonObject::iterator | end() |
QJsonObject::const_iterator | end() const |
QJsonObject::iterator | erase(QJsonObject::iterator it) |
QJsonObject::iterator | find(const QString &key) |
QJsonObject::iterator | find(QLatin1StringView key) |
QJsonObject::iterator | find(QStringView key) |
QJsonObject::const_iterator | find(QLatin1StringView key) const |
QJsonObject::const_iterator | find(QStringView key) const |
QJsonObject::const_iterator | find(const QString &key) const |
QJsonObject::iterator | insert(const QString &key, const QJsonValue &value) |
QJsonObject::iterator | insert(QLatin1StringView key, const QJsonValue &value) |
QJsonObject::iterator | insert(QStringView key, const QJsonValue &value) |
bool | isEmpty() const |
QStringList | keys() const |
qsizetype | length() const |
void | remove(const QString &key) |
void | remove(QLatin1StringView key) |
void | remove(QStringView key) |
qsizetype | size() const |
void | swap(QJsonObject &other) |
QJsonValue | take(const QString &key) |
QJsonValue | take(QLatin1StringView key) |
QJsonValue | take(QStringView key) |
QVariantHash | toVariantHash() const |
QVariantMap | toVariantMap() const |
QJsonValue | value(const QString &key) const |
QJsonValue | value(QLatin1StringView key) const |
QJsonValue | value(QStringView key) const |
QJsonObject & | operator=(QJsonObject &&other) |
QJsonObject & | operator=(const QJsonObject &other) |
QJsonValueRef | operator[](const QString &key) |
QJsonValue | operator[](const QString &key) const |
QJsonValueRef | operator[](QLatin1StringView key) |
QJsonValueRef | operator[](QStringView key) |
QJsonValue | operator[](QLatin1StringView key) const |
QJsonValue | operator[](QStringView key) const |
Statische öffentliche Mitglieder
QJsonObject | fromVariantHash(const QVariantHash &hash) |
QJsonObject | fromVariantMap(const QVariantMap &map) |
Verwandte Nicht-Mitglieder
bool | operator!=(const QJsonObject &lhs, const QJsonObject &rhs) |
bool | operator==(const QJsonObject &lhs, const QJsonObject &rhs) |
Detaillierte Beschreibung
Ein JSON-Objekt ist eine Liste von Schlüssel-Wert-Paaren, wobei die Schlüssel eindeutige Zeichenketten sind und die Werte durch ein QJsonValue dargestellt werden.
Ein QJsonObject kann in und aus einem QVariantMap konvertiert werden. Sie können die Anzahl der (Schlüssel-, Wert-) Paare mit size(), insert() und remove() Einträgen abfragen und über den Inhalt iterieren, indem Sie das Standard-C++-Iteratormuster verwenden.
QJsonObject ist eine implizit gemeinsam genutzte Klasse und teilt die Daten mit dem Dokument, aus dem es erstellt wurde, solange es nicht verändert wird.
Sie können das Objekt über QJsonDocument in und aus textbasiertem JSON konvertieren.
Siehe auch JSON-Unterstützung in Qt und Speichern und Laden eines Spiels.
Dokumentation der Membertypen
QJsonObject::ConstIterator
Qt-style ist ein Synonym für QJsonObject::const_iterator.
QJsonObject::Iterator
Qt-style ist ein Synonym für QJsonObject::iterator.
QJsonObject::key_type
Typedef für QString. Wird für die STL-Kompatibilität bereitgestellt.
QJsonObject::mapped_type
Typedef für QJsonValue. Wird für die STL-Kompatibilität bereitgestellt.
QJsonObject::size_type
Typendefinition für qsizetype. Wird für STL-Kompatibilität bereitgestellt.
Dokumentation der Mitgliedsfunktionen
QJsonObject::QJsonObject()
Konstruiert ein leeres JSON-Objekt.
Siehe auch isEmpty().
QJsonObject::QJsonObject(std::initializer_list<std::pair<QString, QJsonValue>> args)
Konstruiert eine QJsonObject-Instanz, die aus der args Initialisierungsliste initialisiert wird. Zum Beispiel:
QJsonObject object { {"property1", 1}, {"property2", 2} };
[noexcept]
QJsonObject::QJsonObject(const QJsonObject &other)
Erzeugt eine Kopie von other.
Da QJsonObject implizit gemeinsam genutzt wird, ist die Kopie oberflächlich, solange das Objekt nicht verändert wird.
[noexcept]
QJsonObject::QJsonObject(QJsonObject &&other)
Move-konstruiert ein QJsonObject aus other.
[noexcept]
QJsonObject::~QJsonObject()
Zerstört das Objekt.
QJsonObject::iterator QJsonObject::begin()
Gibt einen Iterator im STL-Stil zurück, der auf das erste Element des Objekts zeigt.
Siehe auch constBegin() und end().
QJsonObject::const_iterator QJsonObject::begin() const
Dies ist eine überladene Funktion.
QJsonObject::const_iterator QJsonObject::constBegin() const
Gibt einen Iterator im Stil von const STL zurück, der auf das erste Element des Objekts zeigt.
Siehe auch begin() und constEnd().
QJsonObject::const_iterator QJsonObject::constEnd() const
Gibt einen const STL-artigen Iterator zurück, der auf das imaginäre Element nach dem letzten Element des Objekts zeigt.
Siehe auch constBegin() und end().
QJsonObject::const_iterator QJsonObject::constFind(const QString &key) const
Gibt einen konstanten Iterator zurück, der auf das Element mit dem Schlüssel key in der Map zeigt.
Wenn die Karte kein Element mit dem Schlüssel key enthält, gibt die Funktion constEnd() zurück.
QJsonObject::const_iterator QJsonObject::constFind(QLatin1StringView key) const
Dies ist eine überladene Funktion.
QJsonObject::const_iterator QJsonObject::constFind(QStringView key) const
Dies ist eine überladene Funktion.
bool QJsonObject::contains(const QString &key) const
Gibt true
zurück, wenn das Objekt den Schlüssel key enthält.
Siehe auch insert(), remove(), und take().
bool QJsonObject::contains(QLatin1StringView key) const
Dies ist eine überladene Funktion.
bool QJsonObject::contains(QStringView key) const
Dies ist eine überladene Funktion.
qsizetype QJsonObject::count() const
Dies ist eine überladene Funktion.
Dasselbe wie size().
bool QJsonObject::empty() const
Diese Funktion ist aus Gründen der STL-Kompatibilität vorgesehen. Sie ist äquivalent zu isEmpty() und gibt true
zurück, wenn das Objekt leer ist; andernfalls gibt sie false
zurück.
QJsonObject::iterator QJsonObject::end()
Gibt einen Iterator im STL-Stil zurück, der auf das imaginäre Element nach dem letzten Element des Objekts zeigt.
Siehe auch begin() und constEnd().
QJsonObject::const_iterator QJsonObject::end() const
Dies ist eine überladene Funktion.
QJsonObject::iterator QJsonObject::erase(QJsonObject::iterator it)
Entfernt das Paar (Schlüssel, Wert), auf das der Iterator it zeigt, aus der Map und gibt einen Iterator zum nächsten Element in der Map zurück.
Siehe auch remove().
QJsonObject::iterator QJsonObject::find(const QString &key)
Gibt einen Iterator zurück, der auf das Element mit dem Schlüssel key in der Map zeigt.
Wenn die Karte kein Element mit dem Schlüssel key enthält, gibt die Funktion end() zurück.
QJsonObject::iterator QJsonObject::find(QLatin1StringView key)
Dies ist eine überladene Funktion.
QJsonObject::iterator QJsonObject::find(QStringView key)
Dies ist eine überladene Funktion.
QJsonObject::const_iterator QJsonObject::find(QLatin1StringView key) const
Dies ist eine überladene Funktion.
QJsonObject::const_iterator QJsonObject::find(QStringView key) const
Dies ist eine überladene Funktion.
QJsonObject::const_iterator QJsonObject::find(const QString &key) const
Dies ist eine überladene Funktion.
[static]
QJsonObject QJsonObject::fromVariantHash(const QVariantHash &hash)
Wandelt den Varianten-Hash hash in einen QJsonObject um.
Die Schlüssel in hash werden als Schlüssel im JSON-Objekt verwendet, und die Werte von QVariant werden in JSON-Werte umgewandelt.
Hinweis: Die Konvertierung von QVariant ist nicht völlig verlustfrei. Bitte lesen Sie die Dokumentation in QJsonValue::fromVariant() für weitere Informationen.
Siehe auch fromVariantMap(), toVariantHash(), und QJsonValue::fromVariant().
[static]
QJsonObject QJsonObject::fromVariantMap(const QVariantMap &map)
Konvertiert die Variant Map map in eine QJsonObject.
Die Schlüssel in map werden als Schlüssel im JSON-Objekt verwendet, und die Werte von QVariant werden in JSON-Werte umgewandelt.
Hinweis: Die Konvertierung von QVariant ist nicht völlig verlustfrei. Bitte lesen Sie die Dokumentation in QJsonValue::fromVariant() für weitere Informationen.
Siehe auch fromVariantHash(), toVariantMap(), und QJsonValue::fromVariant().
QJsonObject::iterator QJsonObject::insert(const QString &key, const QJsonValue &value)
Fügt ein neues Element mit dem Schlüssel key und einem Wert von value ein.
Wenn es bereits ein Element mit dem Schlüssel key gibt, wird der Wert dieses Elements durch value ersetzt.
Gibt einen Iterator zurück, der auf das eingefügte Element zeigt.
Wenn der Wert QJsonValue::Undefined ist, wird der Schlüssel aus dem Objekt entfernt. Der zurückgegebene Iterator verweist dann auf end().
Siehe auch remove(), take(), QJsonObject::iterator, und end().
QJsonObject::iterator QJsonObject::insert(QLatin1StringView key, const QJsonValue &value)
Dies ist eine überladene Funktion.
QJsonObject::iterator QJsonObject::insert(QStringView key, const QJsonValue &value)
Dies ist eine überladene Funktion.
bool QJsonObject::isEmpty() const
Gibt true
zurück, wenn das Objekt leer ist. Dies ist dasselbe wie size() == 0.
Siehe auch size().
QStringList QJsonObject::keys() const
Gibt eine Liste aller Schlüssel in diesem Objekt zurück.
Die Liste ist alphabetisch sortiert.
qsizetype QJsonObject::length() const
Dies ist eine überladene Funktion.
Dasselbe wie size().
void QJsonObject::remove(const QString &key)
Entfernt key aus dem Objekt.
Siehe auch insert() und take().
void QJsonObject::remove(QLatin1StringView key)
Dies ist eine überladene Funktion.
void QJsonObject::remove(QStringView key)
Dies ist eine überladene Funktion.
qsizetype QJsonObject::size() const
Gibt die Anzahl der im Objekt gespeicherten Paare (Schlüssel, Wert) zurück.
[noexcept]
void QJsonObject::swap(QJsonObject &other)
Tauscht dieses Objekt mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.
QJsonValue QJsonObject::take(const QString &key)
Entfernt key aus dem Objekt.
Gibt ein QJsonValue zurück, das den von key referenzierten Wert enthält. Wenn key nicht im Objekt enthalten war, ist das zurückgegebene QJsonValue QJsonValue::Undefined .
Siehe auch insert(), remove(), und QJsonValue.
QJsonValue QJsonObject::take(QLatin1StringView key)
Dies ist eine überladene Funktion.
QJsonValue QJsonObject::take(QStringView key)
Dies ist eine überladene Funktion.
QVariantHash QJsonObject::toVariantHash() const
Wandelt dieses Objekt in ein QVariantHash um.
Gibt den erstellten Hash zurück.
Siehe auch toVariantMap().
QVariantMap QJsonObject::toVariantMap() const
Konvertiert dieses Objekt in eine QVariantMap.
Gibt die erstellte Karte zurück.
Siehe auch toVariantHash().
QJsonValue QJsonObject::value(const QString &key) const
Gibt ein QJsonValue zurück, das den Wert für den Schlüssel key darstellt.
Der zurückgegebene QJsonValue ist QJsonValue::Undefined, wenn der Schlüssel nicht existiert.
Siehe auch QJsonValue und QJsonValue::isUndefined().
QJsonValue QJsonObject::value(QLatin1StringView key) const
Dies ist eine überladene Funktion.
QJsonValue QJsonObject::value(QStringView key) const
Dies ist eine überladene Funktion.
[noexcept]
QJsonObject &QJsonObject::operator=(QJsonObject &&other)
Verschieben - weist other diesem Objekt zu.
[noexcept]
QJsonObject &QJsonObject::operator=(const QJsonObject &other)
Weist diesem Objekt other zu.
QJsonValueRef QJsonObject::operator[](const QString &key)
Gibt einen Verweis auf den Wert für key zurück. Ist kein Wert mit dem Schlüssel key im Objekt vorhanden, wird einer mit dem Wert QJsonValue::Null erstellt und dann zurückgegeben.
Der Rückgabewert ist vom Typ QJsonValueRef, einer Hilfsklasse für QJsonArray und QJsonObject. Wenn Sie ein Objekt vom Typ QJsonValueRef erhalten, können Sie es so verwenden, als wäre es eine Referenz auf QJsonValue. Wenn Sie es zuweisen, gilt die Zuweisung für das Element in QJsonArray oder QJsonObject, von dem Sie die Referenz erhalten haben.
Siehe auch value().
QJsonValue QJsonObject::operator[](const QString &key) const
Gibt ein QJsonValue zurück, das den Wert für den Schlüssel key darstellt.
Diese Funktion entspricht der Funktion value().
Der zurückgegebene QJsonValue ist QJsonValue::Undefined, wenn der Schlüssel nicht existiert.
Siehe auch value(), QJsonValue, und QJsonValue::isUndefined().
QJsonValueRef QJsonObject::operator[](QLatin1StringView key)
Dies ist eine überladene Funktion.
QJsonValueRef QJsonObject::operator[](QStringView key)
Dies ist eine überladene Funktion.
QJsonValue QJsonObject::operator[](QLatin1StringView key) const
Dies ist eine überladene Funktion.
QJsonValue QJsonObject::operator[](QStringView key) const
Dies ist eine überladene Funktion.
Verwandte Nicht-Mitglieder
[noexcept]
bool operator!=(const QJsonObject &lhs, const QJsonObject &rhs)
Gibt true
zurück, wenn das Objekt lhs nicht gleich rhs ist, andernfalls false
.
[noexcept]
bool operator==(const QJsonObject &lhs, const QJsonObject &rhs)
Gibt true
zurück, wenn das Objekt lhs gleich rhs ist, andernfalls false
.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.