QJsonObject Class

Documentation des fonctions membres

QJsonObject::QJsonObject()

Crée un objet JSON vide.

Voir aussi isEmpty().

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

Crée une instance de `QJsonObject` initialisée à partir d'args e liste d'initialisation. Par exemple :

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

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

Crée une copie de other.

Comme QJsonObject est implicitement partagé, la copie est superficielle tant que l'objet n'est pas modifié.

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

Crée un objet QJsonObject à partir de other.

[noexcept] QJsonObject::~QJsonObject()

Détruit l'objet.

Renvoie un objet de plage qui permet de parcourir cet objet sous forme de paires clé/valeur. Par exemple, cet objet de plage peut être utilisé dans une boucle « for » basée sur une plage, en combinaison avec une déclaration de liaison structurée :

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

for (auto [key, value]: obj.asKeyValueRange()) {
    qDebug() << key << "->" << value;
   if (key== "object")
        value = "!"; // modifier l'objet associé à cette clé
}
qDebug() << obj["object"]; // QJsonValue(string, "!")

Notez que la valeur ainsi obtenue est une référence à celle contenue dans l’objet. Plus précisément, la modification de cette valeur entraînera la modification de l’objet lui-même.

Lorsque cette méthode est appelée sur des valeurs r (par exemple sur une variable temporaire créée dans l'initialiseur d'une boucle « for » avec plage), l'objet sera capturé dans cette plage.

Ces fonctions ont été introduites dans Qt 6.10.

Voir également QKeyValueIterator.

QJsonObject::iterator QJsonObject::begin()

Renvoie un itérateur de type STL pointant vers le premier élément de l'objet.

Voir également constBegin() et end().

QJsonObject::const_iterator QJsonObject::begin() const

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

Renvoie un itérateur de type STL (const) pointant vers le premier élément de l'objet.

Cette fonction a été introduite dans Qt 6.12.

Voir également begin() et cend().

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

Renvoie un itérateur de type STL (const) pointant vers l'élément imaginaire situé après le dernier élément de l'objet.

Cette fonction a été introduite dans Qt 6.12.

Voir également cbegin() et end().

QJsonObject::const_iterator QJsonObject::constBegin() const

Renvoie un itérateur de type STL constant pointant vers le premier élément de l'objet.

Voir également begin() et constEnd().

QJsonObject::const_iterator QJsonObject::constEnd() const

Renvoie un itérateur de type STL (const) pointant vers l'élément imaginaire situé après le dernier élément de l'objet.

Voir également constBegin() et end().

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

Renvoie un itérateur const pointant vers l'élément de la carte dont la clé est « key ».

Si la table ne contient aucun élément ayant pour clé « key », la fonction renvoie 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

Renvoie un itérateur de type STL (const) pointant vers la première entrée de l'objet.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi keyValueBegin().

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

Renvoie un itérateur de type STL (const) pointant vers l'entrée imaginaire située après la dernière entrée de l'objet.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi ` constKeyValueBegin()`.

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

Renvoie « true » si l'objet contient la clé « key ».

Voir également insert(), remove() et take().

bool QJsonObject::contains(QLatin1StringView key) const

bool QJsonObject::contains(QStringView key) const

qsizetype QJsonObject::count() const

Identique à ` size()`.

bool QJsonObject::empty() const

Cette fonction est fournie à des fins de compatibilité avec la STL. Elle équivaut à ` isEmpty()`, qui renvoie ` true ` si l'objet est vide ; sinon, elle renvoie ` false`.

QJsonObject::iterator QJsonObject::end()

Renvoie un itérateur de type STL pointant vers l'élément imaginaire situé après le dernier élément de l'objet.

Voir également begin() et constEnd().

QJsonObject::const_iterator QJsonObject::end() const

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

Supprime de la table la paire (clé, valeur) pointée par l'itérateur it, puis renvoie un itérateur vers l'élément suivant de la table.

Voir également remove().

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

Renvoie un itérateur pointant vers l'élément de la carte dont la clé est « key ».

Si la table ne contient aucun élément avec la clé « key », la fonction renvoie ` 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)

Convertit le hachage de variante hash en un objet QJsonObject.

Les clés de hash seront utilisées comme clés dans l’objet JSON, et les valeurs de QVariant seront converties en valeurs JSON.

Voir également fromVariantMap(), toVariantHash() et QJsonValue::fromVariant().

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

Convertit la carte de variantes map en un objet QJsonObject.

Les clés de map seront utilisées comme clés dans l'objet JSON, et les valeurs de QVariant seront converties en valeurs JSON.

Voir également fromVariantHash(), toVariantMap() et QJsonValue::fromVariant().

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

Insère un nouvel élément avec la clé « key » et la valeur « value ».

S'il existe déjà un élément avec la clé key, la valeur de cet élément est alors remplacée par value.

Renvoie un itérateur pointant vers l'élément inséré.

Si la valeur est QJsonValue::Undefined, la clé sera supprimée de l’objet. L’itérateur renvoyé pointera alors vers end().

Voir également remove(), take(), QJsonObject::iterator et end().

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

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

bool QJsonObject::isEmpty() const

Renvoie « true » si l'objet est vide. Cela revient à vérifier si « size() » est égal à 0.

Voir aussi size().

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

Renvoie un itérateur de type STL pointant vers la première entrée de l'objet.

Cette fonction a été introduite dans Qt 6.10.

Voir également ` keyValueEnd()`.

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

Renvoie un itérateur de type STL (const) pointant vers la première entrée de l'objet.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi keyValueEnd().

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

Renvoie un itérateur de type STL pointant vers l'entrée imaginaire située après la dernière entrée de l'objet.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi ` keyValueBegin()`.

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

Renvoie un itérateur de type STL (const) pointant vers l'entrée imaginaire située après la dernière entrée de l'objet.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi keyValueBegin().

QStringList QJsonObject::keys() const

Renvoie une liste de toutes les clés de cet objet.

La liste est triée par ordre alphabétique.

qsizetype QJsonObject::length() const

Identique à ` size()`.

void QJsonObject::remove(const QString &key)

Supprime la propriété « key » de l'objet.

Voir également ` insert()` et ` take()`.

void QJsonObject::remove(QLatin1StringView key)

void QJsonObject::remove(QStringView key)

qsizetype QJsonObject::size() const

Renvoie le nombre de paires (clé, valeur) stockées dans l'objet.

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

Permute cet objet avec other. Cette opération est très rapide et ne rencontre jamais d'échec.

QJsonValue QJsonObject::take(const QString &key)

Supprime l'key de l'objet.

Renvoie une instance de ` QJsonValue ` contenant la valeur référencée par ` key`. Si ` key ` n'était pas présent dans l'objet, l'instance de ` QJsonValue ` renvoyée est ` QJsonValue::Undefined`.

Voir également insert(), remove() et QJsonValue.

QJsonValue QJsonObject::take(QLatin1StringView key)

QJsonValue QJsonObject::take(QStringView key)

QVariantHash QJsonObject::toVariantHash() const

Convertit cet objet en un ` QVariantHash`.

Renvoie le hachage créé.

Voir aussi toVariantMap().

QVariantMap QJsonObject::toVariantMap() const

Convertit cet objet en une carte de type « QVariantMap ».

Renvoie la carte créée.

Voir aussi toVariantHash().

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

Renvoie un objet ` QJsonValue ` représentant la valeur associée à la clé ` key`.

L'QJsonValue renvoyée est QJsonValue::Undefined si la clé n'existe pas.

Voir également ` QJsonValue ` et ` QJsonValue::isUndefined()`.

QJsonValue QJsonObject::value(QLatin1StringView key) const

QJsonValue QJsonObject::value(QStringView key) const

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

La commande « Move » attribue la valeur « other » à cet objet.

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

Attribue « other » à cet objet.

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

Renvoie une référence à la valeur associée à « key ». Si l'objet ne contient aucune valeur associée à la clé « key », une valeur est créée avec la valeur « QJsonValue::Null », puis renvoyée.

La valeur renvoyée est de type ` QJsonValueRef`, une classe auxiliaire pour ` QJsonArray ` et ` QJsonObject`. Lorsque vous obtenez un objet de type ` QJsonValueRef`, vous pouvez l’utiliser comme s’il s’agissait d’une référence à un ` QJsonValue`. Si vous lui attribuez une valeur, l’affectation s’appliquera à l’élément de ` QJsonArray ` ou ` QJsonObject ` à partir duquel vous avez obtenu la référence.

Voir également value().

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

Renvoie un objet ` QJsonValue ` représentant la valeur associée à la clé ` key`.

Cette fonction a le même effet que ` value()`.

L'QJsonValue renvoyée est QJsonValue::Undefined si la clé n'existe pas.

Voir également value(), QJsonValue et QJsonValue::isUndefined().

QJsonValueRef QJsonObject::operator[](QLatin1StringView key)

QJsonValueRef QJsonObject::operator[](QStringView key)

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

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