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

Diese Klasse ist gleichsetzbar.

Diese Klasse ist gleichwertig mit QJsonValue und QJsonValueConstRef.

Hinweis: Alle Funktionen in dieser Klasse sind reentrant.

Öffentliche Typen

Ö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)
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.