QCborMap Class

Documentation des fonctions membres

[noexcept] QCborMap::QCborMap()

Crée un objet CBOR Map vide.

Voir également isEmpty().

QCborMap::QCborMap(std::initializer_list<QCborMap::value_type> args)

Crée un objet `QCborMap` à partir des éléments d'une liste d'initialisation entre accolades disponible à l'adresse args, comme dans l'exemple suivant :

QCborMap map = {
    {0, "Hello"},
    {1, "World"},
    {"foo", nullptr},
    {"bar", QCborArray{0, 1, 2, 3, 4}}
};

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

Crée un objet QCborMap qui est une copie de other.

[constexpr noexcept default, since 6.10] QCborMap::QCborMap(QCborMap &&other)

Constructeur de déplacement.

L'objet d'origine other est placé dans l'état de construction par défaut.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi QCborMap::QCborMap().

[noexcept] QCborMap::~QCborMap()

Détruit cet objet ` QCborMap ` et libère toutes les ressources associées dont il est propriétaire.

Renvoie un objet « range » permettant de parcourir cette carte sous forme de paires clé/valeur.

Notez que les valeurs ainsi obtenues sont des références aux valeurs contenues dans la table. Plus précisément, la modification d'une valeur entraînera la modification de la table elle-même.

Ces fonctions ont été introduites dans Qt 6.10.

Voir également QKeyValueIterator.

QCborMap::iterator QCborMap::begin()

Renvoie un itérateur de carte pointant vers la première paire clé-valeur de cette carte. Si cette carte est vide, l'itérateur renvoyé sera identique à celui de la fonction end().

Voir également constBegin() et end().

QCborMap::const_iterator QCborMap::begin() const

Renvoie un itérateur de carte pointant vers la première paire clé-valeur de cette carte. Si cette carte est vide, l'itérateur renvoyé sera identique à celui de la fonction constEnd().

Voir également ` cbegin()` et ` constEnd()`.

QCborMap::const_iterator QCborMap::cbegin() const

Renvoie un itérateur de carte pointant vers la première paire clé-valeur de cette carte. Si cette carte est vide, l'itérateur renvoyé sera identique à celui de la fonction constEnd().

Voir également begin() et constEnd().

QCborMap::const_iterator QCborMap::cend() const

Renvoie un itérateur de carte représentant un élément situé juste après le dernier élément de la carte.

Voir également begin(), constBegin(), find() et constFind().

void QCborMap::clear()

Vide cette carte.

Voir aussi isEmpty().

[noexcept] int QCborMap::compare(const QCborMap &other) const

Compare cette carte à celle de other, en comparant chaque élément l'un après l'autre, et renvoie un entier indiquant si cette carte doit être triée avant (si le résultat est négatif) ou après other (si le résultat est positif). Si cette fonction renvoie 0, les deux cartes sont égales et contiennent les mêmes éléments.

Notez que les cartes CBOR ne sont pas ordonnées, ce qui signifie que deux cartes contenant exactement les mêmes paires, mais dans un ordre différent, donneront tout de même un résultat différent lors de la comparaison. Pour éviter cela, il est recommandé d’insérer les éléments dans la carte selon un ordre prévisible, par exemple par ordre croissant de la valeur de la clé. En effet, les cartes dont les clés sont triées sont obligatoires pour la représentation CBOR canonique.

Pour plus d’informations sur l’ordre de tri CBOR, voir QCborValue::compare().

Voir également QCborValue::compare(), QCborArray::compare() et operator==().

QCborMap::const_iterator QCborMap::constBegin() const

Renvoie un itérateur de carte pointant vers la première paire clé-valeur de cette carte. Si cette carte est vide, l'itérateur renvoyé sera identique à celui de la fonction constEnd().

Voir également begin() et constEnd().

QCborMap::const_iterator QCborMap::constEnd() const

Renvoie un itérateur de carte représentant un élément situé juste après le dernier élément de la carte.

Voir également begin(), constBegin(), find() et constFind().

QCborMap::const_iterator QCborMap::constFind(qint64 key) const

Renvoie un itérateur de la carte pointant vers la paire clé-valeur dont la clé est key, si la carte contient une telle paire. Dans le cas contraire, cette fonction renvoie constEnd().

Le CBOR recommande d’utiliser des clés entières, car elles occupent moins d’espace et sont plus simples à encoder et à décoder.

Si la table contient plusieurs clés égales à key, il n’est pas défini laquelle cette fonction trouvera. QCborMap n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR qui en contient. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème chez l’expéditeur.

Voir également value(qint64), operator[](qint64), find(qint64), remove(qint64), contains(qint64), value(QLatin1StringView), value(const QString &) et value(const QCborValue &).

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

Renvoie un itérateur de carte pointant vers la paire clé-valeur dont la clé est key, si la carte contient une telle paire. Si ce n'est pas le cas, cette fonction renvoie constEnd().

Si la carte contient plusieurs clés égales à key, il est indéterminé laquelle cette fonction trouvera. QCborMap n'autorise pas l'insertion de clés en double, mais il est possible de créer une telle carte en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème chez l'expéditeur.

Voir également value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), remove(QLatin1StringView), contains(QLatin1StringView), value(qint64), value(const QString &) et value(const QCborValue &).

QCborMap::const_iterator QCborMap::constFind(const QCborValue &key) const

Renvoie un itérateur de la carte pointant vers la paire clé-valeur dont la clé est « key », si la carte contient une telle paire. Dans le cas contraire, cette fonction renvoie « constEnd() ».

Si la carte contient plusieurs clés égales à key, il est indéfini laquelle cette fonction trouvera. QCborMap n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle carte en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

Voir également value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), remove(const QCborValue &), contains(const QCborValue &), value(qint64), value(QLatin1StringView) et value(const QString &).

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

Renvoie un itérateur de la carte pointant vers la paire clé-valeur dont la clé est « key », si la carte contient une telle paire. Dans le cas contraire, cette fonction renvoie « constEnd() ».

Si la carte contient plusieurs clés égales à key, il est indéterminé laquelle cette fonction trouvera. QCborMap n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle carte en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

Voir également value(const QString &), operator[](const QString &), find(const QString &), remove(const QString &), contains(const QString &), value(qint64), value(QLatin1StringView) et value(const QCborValue &).

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

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

Cette fonction a été introduite dans Qt 6.10.

Voir également ` keyValueBegin()`.

[since 6.10] QCborMap::const_key_value_iterator QCborMap::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 la table.

Cette fonction a été introduite dans Qt 6.10.

Voir également ` constKeyValueBegin()`.

bool QCborMap::contains(const QCborValue &key) const

Renvoie « true » si cette carte contient une paire clé-valeur identifiée par la clé « key ».

Voir également value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), remove(const QCborValue &), contains(qint64), remove(QLatin1StringView) et remove(const QString &).

bool QCborMap::contains(qint64 key) const

Renvoie « true » si cette carte contient une paire clé-valeur identifiée par la clé key. Le CBOR recommande d'utiliser des clés entières, car elles occupent moins d'espace et sont plus simples à encoder et à décoder.

Voir également value(qint64), operator[](qint64), find(qint64), remove(qint64), contains(QLatin1StringView), remove(const QString &) et remove(const QCborValue &).

bool QCborMap::contains(QLatin1StringView key) const

Renvoie « true » si cette carte contient une paire clé-valeur identifiée par la clé « key ».

Voir également value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), remove(QLatin1StringView), contains(qint64), remove(const QString &) et remove(const QCborValue &).

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

Renvoie « true » si cette carte contient une paire clé-valeur identifiée par la clé « key ».

Voir également value(const QString &), operator[](const QString &), find(const QString &), remove(const QString &), contains(qint64), remove(QLatin1StringView) et remove(const QCborValue &).

bool QCborMap::empty() const

Synonyme de ` isEmpty()`. Cette fonction est fournie à des fins de compatibilité avec le code générique qui utilise l'API de la bibliothèque standard.

Renvoie « true » si cette table est vide (size() == 0).

Voir également isEmpty() et size().

QCborMap::iterator QCborMap::end()

Renvoie un itérateur de carte représentant un élément situé juste après le dernier élément de la carte.

Voir également begin(), constBegin(), find() et constFind().

QCborMap::const_iterator QCborMap::end() const

Renvoie un itérateur de carte représentant un élément situé juste après le dernier élément de la carte.

Voir également begin(), constBegin(), find() et constFind().

QCborMap::iterator QCborMap::erase(QCborMap::const_iterator it)

Supprime la paire clé-valeur pointée par l’itérateur de la carte it et renvoie un pointeur vers l’élément suivant, une fois la suppression effectuée.

Voir également remove(), begin(), end(), insert() et extract().

QCborMap::iterator QCborMap::erase(QCborMap::iterator it)

Supprime la paire clé-valeur à laquelle pointe l'itérateur de la carte it et renvoie un pointeur vers l'élément suivant, une fois la suppression effectuée.

Voir également remove(), begin(), end() et insert().

Extrait une valeur de la carte à la position indiquée par l'itérateur it et renvoie la valeur ainsi extraite.

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

Renvoie un itérateur de la carte pointant vers la paire clé-valeur dont la clé est key, si la carte contient une telle paire. Dans le cas contraire, cette fonction renvoie end().

Le CBOR recommande d’utiliser des clés entières, car elles occupent moins d’espace et sont plus simples à encoder et à décoder.

Si la table contient plusieurs clés égales à key, il n’est pas défini laquelle cette fonction trouvera. QCborMap n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR qui en contient. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème chez l’expéditeur.

Voir également value(qint64), operator[](qint64), constFind(qint64), remove(qint64), contains(qint64), value(QLatin1StringView), value(const QString &) et value(const QCborValue &).

Renvoie un itérateur de map pointant vers la paire clé-valeur dont la clé est key, si la map contient une telle paire. Dans le cas contraire, cette fonction renvoie end().

Si la carte contient plusieurs clés égales à key, il est indéfini laquelle cette fonction trouvera. QCborMap n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle carte en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

Voir également value(QLatin1StringView), operator[](QLatin1StringView), constFind(QLatin1StringView), remove(QLatin1StringView), contains(QLatin1StringView), value(qint64), value(const QString &) et value(const QCborValue &).

Renvoie un itérateur de carte pointant vers la paire clé-valeur dont la clé est « key », si la carte contient une telle paire. Si ce n'est pas le cas, cette fonction renvoie « end() ».

Si la carte contient plusieurs clés égales à key, il n’est pas défini laquelle cette fonction trouvera. QCborMap n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle carte en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

Voir également value(const QCborValue &), operator[](const QCborValue &), constFind(const QCborValue &), remove(const QCborValue &), contains(const QCborValue &), value(qint64), value(QLatin1StringView) et value(const QString &).

Renvoie un itérateur de carte pointant vers la paire clé-valeur dont la clé est « key », si la carte contient une telle paire. Dans le cas contraire, cette fonction renvoie « end() ».

Si la table contient plusieurs clés égales à key, il n’est pas défini laquelle cette fonction trouvera. QCborMap n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

Voir également value(const QString &), operator[](const QString &), constFind(const QString &), remove(const QString &), contains(const QString &), value(qint64), value(QLatin1StringView) et value(const QCborValue &).

[static] QCborMap QCborMap::fromJsonObject(const QJsonObject &obj)

Convertit tous les éléments JSON présents dans l’objet ` obj ` au format CBOR à l’aide de la fonction `QCborValue::fromJson()`, puis renvoie la carte composée de ces éléments.

Cette conversion s'effectue sans perte, car le système de types CBOR est un sur-ensemble de celui de JSON. De plus, la carte renvoyée par cette fonction peut être reconvertie en l'objet obj d'origine à l'aide de toJsonObject().

Voir également toJsonObject(), toVariantMap(), QCborValue::fromJsonValue() et QCborArray::fromJsonArray().

[static noexcept, since 6.3] QCborMap QCborMap::fromJsonObject(QJsonObject &&obj)

Cette fonction a été introduite dans Qt 6.3.

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

Convertit tous les éléments de ` hash ` au format CBOR à l'aide de ` QCborValue::fromVariant()` et renvoie la table de correspondance composée de ces éléments.

La conversion à partir de ` QVariant ` n’est pas entièrement sans perte. Veuillez consulter la documentation relative à ` QCborValue::fromVariant()` pour plus d’informations.

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

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

Convertit tous les éléments de ` map ` au format CBOR à l'aide de ` QCborValue::fromVariant()` et renvoie la carte composée de ces éléments.

La conversion à partir d’ QVariant n’est pas totalement sans perte. Veuillez consulter la documentation relative à QCborValue::fromVariant() pour plus d’informations.

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

QCborMap::iterator QCborMap::insert(QCborMap::value_type v)

Insère la paire clé-valeur de v dans cette carte et renvoie un itérateur de carte pointant vers la paire nouvellement insérée.

Si la carte contenait déjà une clé égale à v.first, sa valeur sera écrasée par v.second.

Voir également operator[], erase() et extract().

QCborMap::iterator QCborMap::insert(QLatin1StringView key, const QCborValue &value)

Insère la clé key et la valeur value dans cette carte et renvoie un itérateur de carte pointant vers la paire nouvellement insérée.

Si la carte contenait déjà une clé égale à key, sa valeur sera remplacée par value.

Voir également erase(), remove(QLatin1StringView), value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), take(QLatin1StringView) et extract().

QCborMap::iterator QCborMap::insert(const QCborValue &key, const QCborValue &value)

Insère la clé key et la valeur value dans cette carte et renvoie un itérateur de carte pointant vers la paire nouvellement insérée.

Si la carte contenait déjà une clé égale à key, sa valeur sera écrasée par value.

Voir également erase(), remove(const QCborValue &), value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), contains(const QCborValue &), take(const QCborValue &) et extract().

QCborMap::iterator QCborMap::insert(const QString &key, const QCborValue &value)

Insère la clé key et la valeur value dans cette carte et renvoie un itérateur de carte pointant vers la paire nouvellement insérée.

Si la carte contenait déjà une clé égale à key, sa valeur sera écrasée par value.

Voir également erase(), remove(const QString &), value(const QString &), operator[](const QString &), find(const QString &), contains(const QString &), take(const QString &) et extract().

QCborMap::iterator QCborMap::insert(qint64 key, const QCborValue &value)

Insère la clé key et la valeur value dans cette carte et renvoie un itérateur de carte pointant vers la paire nouvellement insérée.

Si la carte contenait déjà une clé égale à key, sa valeur sera écrasée par value.

Voir également erase(), remove(qint64), value(qint64), operator[](qint64), find(qint64), contains(qint64), take(qint64) et extract().

bool QCborMap::isEmpty() const

Renvoie « true » si cette carte est vide (c'est-à-dire si la fonction size() renvoie 0).

Voir également size() et clear().

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

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

Cette fonction a été introduite dans Qt 6.10.

Voir également ` keyValueEnd()`.

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

Renvoie un itérateur const de type STL pointant vers la première entrée de la table.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi keyValueEnd().

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

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

Cette fonction a été introduite dans Qt 6.10.

Voir aussi ` keyValueBegin()`.

[since 6.10] QCborMap::const_key_value_iterator QCborMap::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 la table.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi ` keyValueBegin()`.

QList<QCborValue> QCborMap::keys() const

Renvoie une liste de toutes les clés de cette carte.

Voir également QMap::keys() et QHash::keys().

void QCborMap::remove(const QCborValue &key)

Supprime la clé « key » et la valeur correspondante de la table, si elle existe. Si la table ne contient pas cette clé, cette fonction ne fait rien.

Si la table contient plusieurs clés égales à « key », il n’est pas défini laquelle cette fonction supprimera. « QCborMap » n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

remove(qint64), remove(QLatin1StringView), remove(const QString &)

Voir également value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &) et contains(const QCborValue &).

void QCborMap::remove(qint64 key)

Supprime la clé « key » et la valeur correspondante de la table, si celle-ci est trouvée. Si la table ne contient pas cette clé, cette fonction ne fait rien.

Si la table contient plusieurs clés égales à key, il n’est pas défini laquelle cette fonction supprimera. QCborMap n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

remove(QLatin1StringView), remove(const QString &), remove(const QCborValue &)

Voir également value(qint64), operator[](qint64), find(qint64) et contains(qint64).

void QCborMap::remove(QLatin1StringView key)

Supprime la clé « key » et la valeur correspondante de la table, si elle existe. Si la table ne contient pas cette clé, cette fonction ne fait rien.

Si la table contient plusieurs clés égales à « key », il est indéterminé laquelle cette fonction supprimera. La fonction « QCborMap » n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

Voir également value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), remove(qint64), remove(const QString &) et remove(const QCborValue &).

void QCborMap::remove(const QString &key)

Supprime la clé « key » et la valeur correspondante de la table, si elle existe. Si la table ne contient pas cette clé, cette fonction ne fait rien.

Si la table contient plusieurs clés égales à « key », il n'est pas défini laquelle cette fonction supprimera. « QCborMap » n'autorise pas l'insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l'expéditeur.

remove(qint64), remove(QLatin1StringView), remove(const QCborValue &)

Voir également value(const QString &), operator[](const QString &), find(const QString &) et contains(const QString &).

[noexcept] qsizetype QCborMap::size() const

Renvoie le nombre d'éléments contenus dans cette carte.

Voir également isEmpty().

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

Permute cette carte avec celle de other. Cette opération est très rapide et ne pose jamais de problème.

QCborValue QCborMap::take(QLatin1StringView key)

Supprime la clé « key » et la valeur correspondante de la table et renvoie cette valeur si elle est trouvée. Si la table ne contient pas cette clé, cette fonction ne fait rien.

Si la table contient plusieurs clés égales à « key », il n’est pas défini laquelle cette fonction supprimera. La fonction « QCborMap » n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

Voir également value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), take(qint64), take(const QString &), take(const QCborValue &) et insert().

QCborValue QCborMap::take(const QCborValue &key)

Supprime la clé key et la valeur correspondante de la table et renvoie cette valeur si elle est trouvée. Si la table ne contient pas cette clé, cette fonction ne fait rien.

Si la table contient plusieurs clés égales à « key », le choix de la clé que cette fonction supprimera n’est pas défini. La fonction « QCborMap » n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

Voir également value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), contains(const QCborValue &), take(QLatin1StringView), take(const QString &), take(qint64) et insert().

QCborValue QCborMap::take(const QString &key)

Supprime la clé « key » et la valeur correspondante de la table et renvoie cette valeur si elle est trouvée. Si la table ne contient pas cette clé, cette fonction ne fait rien.

Si la table contient plusieurs clés égales à « key », il n’est pas défini laquelle cette fonction supprimera. La fonction « QCborMap » n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

Voir également value(const QString &), operator[](const QString &), find(const QString &), contains(const QString &), take(QLatin1StringView), take(qint64), take(const QCborValue &) et insert().

QCborValue QCborMap::take(qint64 key)

Supprime la clé « key » et la valeur correspondante de la table et renvoie cette valeur si elle est trouvée. Si la table ne contient pas cette clé, cette fonction ne fait rien.

Si la table contient plusieurs clés égales à « key », il n’est pas défini laquelle cette fonction supprimera. La fonction « QCborMap » n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR qui en contient. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

Voir également value(qint64), operator[](qint64), find(qint64), contains(qint64), take(QLatin1StringView), take(const QString &), take(const QCborValue &) et insert().

QCborValue QCborMap::toCborValue() const

Crée explicitement un objet ` QCborValue ` représentant cette carte. Cette fonction n'est généralement pas nécessaire, car ` QCborValue ` dispose d'un constructeur pour ` QCborMap`, ce qui rend la conversion implicite.

La conversion de ` QCborMap ` en ` QCborValue ` permet de l'utiliser dans n'importe quel contexte où `QCborValues` peut être utilisé, y compris comme clés et types mappés dans ` QCborMap`, ainsi que dans ` QCborValue::toCbor()`.

Voir également ` QCborValue::QCborValue(const QCborMap &)`.

QJsonObject QCborMap::toJsonObject() const

Convertit de manière récursive chaque valeur de type « QCborValue » de cette carte en JSON à l'aide de la fonction QCborValue::toJsonValue() et crée une clé de type chaîne de caractères pour toutes les clés qui ne sont pas des chaînes de caractères, puis renvoie l'QJsonObject correspondant, composé de ces associations.

Veuillez noter que CBOR contient un ensemble de types plus riche et plus large que JSON ; certaines informations peuvent donc être perdues lors de cette conversion. Pour plus de détails sur les conversions appliquées, consultez QCborValue::toJsonValue().

Conversion des clés de la carte en chaînes de caractères

Contrairement au CBOR, les objets JSON sont définis comme ayant des clés de type chaîne de caractères ; la conversion d’une « QCborMap » en « QJsonObject » implique donc une étape de « conversion en chaîne » des valeurs des clés. La conversion utilisera le traitement spécial des balises et des types étendus décrit ci-dessus et convertira également les autres types comme suit :

Voir également fromJsonObject(), QCborValue::toJsonValue(), QCborArray::toJsonArray() et toVariantMap().

QVariantHash QCborMap::toVariantHash() const

Convertit les valeurs CBOR en QVariant à l'aide de la fonction QCborValue::toVariant() et « convertit en chaîne » toutes les clés CBOR de cette carte, renvoyant ainsi l'QVariantHash e résultant de cette liste d'associations.

Contrairement au format CBOR, les QVariantMaps possèdent des clés de type chaîne de caractères ; la conversion d’une QCborMap en QVariantMap implique donc une étape de « conversion en chaîne » des valeurs de clé. Voir QCborMap::toJsonObject() pour plus de détails.

De plus, la conversion vers QVariant n’est pas totalement sans perte. Veuillez consulter la documentation à l’adresse QCborValue::toVariant() pour plus d’informations.

Voir également fromVariantHash(), toVariantMap(), toJsonObject(), QCborValue::toVariant() et QCborArray::toVariantList().

QVariantMap QCborMap::toVariantMap() const

Convertit les valeurs CBOR en QVariant à l'aide de la fonction QCborValue::toVariant() et « convertit en chaîne » toutes les clés CBOR de cette carte, renvoyant ainsi l'QVariantMap e résultant de cette liste d'associations.

Contrairement au format CBOR, les QVariantMaps possèdent des clés sous forme de chaînes de caractères ; par conséquent, la conversion d’une QCborMap en QVariantMap implique une étape de « conversion en chaîne » des valeurs des clés. Voir QCborMap::toJsonObject() pour plus de détails.

De plus, la conversion vers QVariant n'est pas totalement sans perte. Veuillez consulter la documentation à l'adresse QCborValue::toVariant() pour plus d'informations.

Voir également fromVariantMap(), toVariantHash(), toJsonObject(), QCborValue::toVariant() et QCborArray::toVariantList().

QCborValue QCborMap::value(const QCborValue &key) const

Renvoie l'élément ` QCborValue ` de cette carte correspondant à la clé ` key`, s'il existe.

Si la table ne contient pas la clé « key », cette fonction renvoie un « QCborValue » contenant une valeur indéfinie. C’est pourquoi il n’est pas possible, avec cette fonction, de distinguer le cas où la clé était absente de celui où elle était associée à une valeur indéfinie.

Si la table contient plusieurs clés égales à ` key`, il n'est pas défini laquelle cette fonction renverra. ` QCborMap ` n'autorise pas l'insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR qui en contient. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l'expéditeur.

value(qint64), value(QLatin1StringView), value(const QString &)

Voir également operator[](const QCborValue &), find(const QCborValue &), constFind(const QCborValue &), remove(const QCborValue &) et contains(const QCborValue &).

QCborValue QCborMap::value(qint64 key) const

Renvoie l'élément « QCborValue » de cette carte qui correspond à la clé « key », s'il existe. Le CBOR recommande d'utiliser des clés entières, car elles occupent moins d'espace et sont plus simples à encoder et à décoder.

Si la table ne contient pas la clé « key », cette fonction renvoie un « QCborValue » contenant une valeur indéfinie. Pour cette raison, il n’est pas possible, avec cette fonction, de distinguer le cas où la clé n’était pas présente de celui où la clé était associée à une valeur indéfinie.

Si la table contient plusieurs clés égales à ` key`, il est indéterminé laquelle sera référencée par la valeur renvoyée par la fonction. ` QCborMap ` n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

value(QLatin1StringView), value(const QString &), value(const QCborValue &)

Voir également operator[](qint64), find(qint64), constFind(qint64), remove(qint64) et contains(qint64).

QCborValue QCborMap::value(QLatin1StringView key) const

Renvoie l'élément « QCborValue » de cette carte correspondant à la clé « key », s'il existe.

Si la table ne contient pas la clé « key », cette fonction renvoie un « QCborValue » contenant une valeur indéfinie. Pour cette raison, il n’est pas possible, avec cette fonction, de distinguer le cas où la clé n’était pas présente de celui où la clé était associée à une valeur indéfinie.

Si la table contient plusieurs clés égales à key, il est indéterminé laquelle cette fonction renverra. QCborMap n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

value(qint64), value(const QString &), value(const QCborValue &)

Voir également operator[](QLatin1StringView), find(QLatin1StringView), constFind(QLatin1StringView), remove(QLatin1StringView) et contains(QLatin1StringView).

QCborValue QCborMap::value(const QString &key) const

Renvoie l'élément « QCborValue » de cette carte qui correspond à la clé « key », s'il existe.

Si la table ne contient pas la clé « key », cette fonction renvoie un « QCborValue » contenant une valeur indéfinie. Pour cette raison, il n’est pas possible, avec cette fonction, de distinguer le cas où la clé n’était pas présente de celui où la clé était associée à une valeur indéfinie.

Si la table contient plusieurs clés égales à ` key`, il est indéfini laquelle cette fonction renverra. ` QCborMap ` n'autorise pas l'insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR qui en contient. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l'expéditeur.

value(qint64), value(QLatin1StringView), value(const QCborValue &)

Voir également operator[](const QString &), find(const QString &), constFind(const QString &), remove(const QString &) et contains(const QString &).

[noexcept, since 6.10] QCborMap &QCborMap::operator=(QCborMap &&other)

Opérateur de déplacement-affectation.

L'objet d'origine other est placé dans un état valide, mais non spécifié.

Cette fonction a été introduite dans Qt 6.10.

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

Remplace le contenu de cet objet par une copie de other, puis renvoie une référence à cet objet.

QCborValueRef QCborMap::operator[](qint64 key)

Renvoie un objet `QCborValueRef` correspondant à la valeur de cette table associée à la clé ` key`. CBOR recommande d'utiliser des clés de type entier, car elles occupent moins d'espace et sont plus simples à encoder et à décoder.

QCborValueRef possède exactement la même API que QCborValue, à une différence importante près : si vous lui attribuez de nouvelles valeurs, cette table sera mise à jour avec ces nouvelles valeurs.

Si la table ne comportait pas de clé égale à « key », une telle clé est alors insérée et cette fonction renvoie une référence à la nouvelle valeur, qui sera de type « QCborValue » avec une valeur indéfinie. Pour cette raison, il n’est pas possible, avec cette fonction, de distinguer le cas où la clé n’existait pas de celui où la clé était associée à une valeur indéfinie.

Si la table contient plusieurs clés égales à key, il est indéterminé à laquelle la valeur renvoyée fera référence. QCborMap n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR qui en contient. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème chez l’expéditeur.

Voir également value(qint64), find(qint64), contains(qint64), remove(qint64), operator[](QLatin1StringView), operator[](const QString &) et operator[](const QCborValue &).

const QCborValue QCborMap::operator[](const QCborValue &key) const

Renvoie l'élément ` QCborValue ` de cette carte qui correspond à la clé ` key`, s'il en existe un.

Si la table ne contient pas la clé « key », cette fonction renvoie un « QCborValue » contenant une valeur indéfinie. Pour cette raison, il n'est pas possible, avec cette fonction, de distinguer le cas où la clé n'était pas présente de celui où la clé était associée à une valeur indéfinie.

Si la table contient plusieurs clés égales à key, il est indéfini laquelle cette fonction renverra. QCborMap n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

opérateur[](qint64), opérateur[](QLatin1StringView), opérateur[](const QCborOperator[] &)

Voir également value(const QCborValue &), find(const QCborValue &), constFind(const QCborValue &), remove(const QCborValue &) et contains(const QCborValue &).

const QCborValue QCborMap::operator[](qint64 key) const

Renvoie l'élément « QCborValue » de cette carte qui correspond à la clé « key », s'il existe. CBOR recommande d'utiliser des clés entières, car elles occupent moins d'espace et sont plus simples à encoder et à décoder.

Si la table ne contient pas la clé « key », cette fonction renvoie un « QCborValue » contenant une valeur indéfinie. Pour cette raison, il n’est pas possible, avec cette fonction, de distinguer le cas où la clé n’était pas présente de celui où la clé était associée à une valeur indéfinie.

Si la table contient plusieurs clés égales à key, il est indéfini laquelle cette fonction renverra. QCborMap n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR les contenant. Elles ne sont généralement pas autorisées et la présence de clés en double est souvent le signe d’un problème chez l’expéditeur.

operator[](QLatin1StringView), operator[](const QString &), operator[](const QCborOperator[] &)

Voir également value(qint64), find(qint64), constFind(qint64), remove(qint64) et contains(qint64).

QCborValueRef QCborMap::operator[](QLatin1StringView key)

Renvoie un objet `QCborValueRef` correspondant à la valeur de cette carte associée à la clé ` key`.

QCborValueRef possède exactement la même API que QCborValue, à une différence importante près : si vous lui attribuez de nouvelles valeurs, cette carte sera mise à jour avec cette nouvelle valeur.

Si la table ne contenait pas de clé égale à « key », celle-ci est insérée et cette fonction renvoie une référence à la nouvelle valeur, qui sera un objet « QCborValue » dont la valeur est non définie. Pour cette raison, il n’est pas possible, avec cette fonction, de distinguer le cas où la clé n’existait pas de celui où la clé était associée à une valeur non définie.

Si la table contient plusieurs clés égales à key, il est indéterminé à laquelle la valeur renvoyée fera référence. QCborMap n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant de telles clés. Celles-ci ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

Voir également value(QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), remove(QLatin1StringView), operator[](qint64), operator[](const QString &) et operator[](const QCborValue &).

QCborValueRef QCborMap::operator[](const QCborValue &key)

Renvoie un objet `QCborValueRef` correspondant à la valeur de cette carte associée à la clé ` key`.

QCborValueRef possède exactement la même API que QCborValue, à une différence importante près : si vous lui attribuez de nouvelles valeurs, cette carte sera mise à jour avec cette nouvelle valeur.

Si la table ne comportait pas de clé égale à « key », une telle clé est alors insérée et cette fonction renvoie une référence à la nouvelle valeur, qui sera un objet de type « QCborValue » avec une valeur indéfinie. Pour cette raison, il n’est pas possible, avec cette fonction, de distinguer le cas où la clé n’existait pas de celui où la clé était associée à une valeur indéfinie.

Si la table contient plusieurs clés égales à « key », il est indéterminé à laquelle la valeur renvoyée fera référence. « QCborMap » n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

Voir également value(const QCborValue &), find(const QCborValue &), contains(const QCborValue &), remove(const QCborValue &), operator[](qint64), operator[](QLatin1StringView) et operator[](const QString &).

QCborValueRef QCborMap::operator[](const QString &key)

Renvoie un objet `QCborValueRef` correspondant à la valeur de cette carte associée à la clé ` key`.

QCborValueRef possède exactement la même API que QCborValue, à une différence importante près : si vous lui attribuez de nouvelles valeurs, cette table sera mise à jour avec ces nouvelles valeurs.

Si la table ne comportait pas de clé égale à « key », une telle clé est alors insérée et cette fonction renvoie une référence à la nouvelle valeur, qui sera un objet « QCborValue » dont la valeur est indéfinie. Pour cette raison, il n’est pas possible, avec cette fonction, de distinguer le cas où la clé n’existait pas de celui où la clé était associée à une valeur indéfinie.

Si la table contient plusieurs clés égales à « key », il est indéterminé à laquelle la valeur renvoyée fera référence. « QCborMap » n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant ces clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

Voir également value(const QString &), find(const QString &), contains(const QString &), remove(const QString &), operator[](qint64), operator[](QLatin1StringView) et operator[](const QCborValue &).

const QCborValue QCborMap::operator[](QLatin1StringView key) const

Renvoie l'élément « QCborValue » de cette carte qui correspond à la clé « key », s'il existe.

Si la table ne contient pas la clé « key », cette fonction renvoie un « QCborValue » contenant une valeur indéfinie. Pour cette raison, il n’est pas possible, avec cette fonction, de distinguer le cas où la clé n’était pas présente de celui où la clé était associée à une valeur indéfinie.

Si la table contient plusieurs clés égales à ` key`, il est indéfini laquelle cette fonction renverra. ` QCborMap ` n’autorise pas l’insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant de telles clés. Elles ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l’expéditeur.

opérateur[](qint64), opérateur[](const QString &), opérateur[](const QCborOperator[] &)

Voir également value(QLatin1StringView), find(QLatin1StringView), constFind(QLatin1StringView), remove(QLatin1StringView) et contains(QLatin1StringView).

const QCborValue QCborMap::operator[](const QString &key) const

Renvoie l'élément ` QCborValue ` de cette carte qui correspond à la clé ` key`, s'il en existe un.

Si la table ne contient pas la clé « key », cette fonction renvoie un « QCborValue » contenant une valeur indéfinie. Pour cette raison, il n’est pas possible, avec cette fonction, de distinguer le cas où la clé n’était pas présente de celui où la clé était associée à une valeur indéfinie.

Si la table contient plusieurs clés égales à key, il est indéterminé laquelle cette fonction renverra. QCborMap n'autorise pas l'insertion de clés en double, mais il est possible de créer une telle table en décodant un flux CBOR contenant de telles clés. Celles-ci ne sont généralement pas autorisées et la présence de clés en double indique souvent un problème au niveau de l'expéditeur.

opérateur[](qint64), opérateur[](QLatin1StringView), opérateur[](const QCborOperator[] &)

Voir également value(const QString &), find(const QString &), constFind(const QString &), remove(const QString &) et contains(const QString &).