Sur cette page

QCborMap Class

La classe QCborMap est utilisée pour contenir un conteneur associatif représentable en CBOR. Plus d'informations...

En-tête : #include <QCborMap>
CMake : find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake : QT += core

Cette classe est fortement comparable.

Cette classe est fortement comparable à QCborValue et QCborValueConstRef.

Note : Toutes les fonctions de cette classe sont réentrantes.

Types publics

Fonctions publiques

QCborMap()
QCborMap(std::initializer_list<QCborMap::value_type> args)
QCborMap(const QCborMap &other)
(since 6.10) QCborMap(QCborMap &&other)
~QCborMap()
(since 6.10) auto asKeyValueRange() &&
(since 6.10) auto asKeyValueRange() &
(since 6.10) auto asKeyValueRange() const &&
(since 6.10) auto asKeyValueRange() const &
QCborMap::iterator begin()
QCborMap::const_iterator begin() const
QCborMap::const_iterator cbegin() const
QCborMap::const_iterator cend() const
void clear()
int compare(const QCborMap &other) const
QCborMap::const_iterator constBegin() const
QCborMap::const_iterator constEnd() const
QCborMap::const_iterator constFind(qint64 key) const
QCborMap::const_iterator constFind(QLatin1StringView key) const
QCborMap::const_iterator constFind(const QCborValue &key) const
QCborMap::const_iterator constFind(const QString &key) const
(since 6.10) QCborMap::const_key_value_iterator constKeyValueBegin() const
(since 6.10) QCborMap::const_key_value_iterator constKeyValueEnd() const
bool contains(const QCborValue &key) const
bool contains(qint64 key) const
bool contains(QLatin1StringView key) const
bool contains(const QString &key) const
bool empty() const
QCborMap::iterator end()
QCborMap::const_iterator end() const
QCborMap::iterator erase(QCborMap::const_iterator it)
QCborMap::iterator erase(QCborMap::iterator it)
QCborValue extract(QCborMap::const_iterator it)
QCborValue extract(QCborMap::iterator it)
QCborMap::iterator find(qint64 key)
QCborMap::const_iterator find(qint64 key) const
QCborMap::iterator find(QLatin1StringView key)
QCborMap::iterator find(const QCborValue &key)
QCborMap::iterator find(const QString &key)
QCborMap::const_iterator find(QLatin1StringView key) const
QCborMap::const_iterator find(const QCborValue &key) const
QCborMap::const_iterator find(const QString &key) const
QCborMap::iterator insert(QCborMap::value_type v)
QCborMap::iterator insert(QLatin1StringView key, const QCborValue &value)
QCborMap::iterator insert(const QCborValue &key, const QCborValue &value)
QCborMap::iterator insert(const QString &key, const QCborValue &value)
QCborMap::iterator insert(qint64 key, const QCborValue &value)
bool isEmpty() const
(since 6.10) QCborMap::key_value_iterator keyValueBegin()
(since 6.10) QCborMap::const_key_value_iterator keyValueBegin() const
(since 6.10) QCborMap::key_value_iterator keyValueEnd()
(since 6.10) QCborMap::const_key_value_iterator keyValueEnd() const
QList<QCborValue> keys() const
void remove(const QCborValue &key)
void remove(qint64 key)
void remove(QLatin1StringView key)
void remove(const QString &key)
qsizetype size() const
void swap(QCborMap &other)
QCborValue take(QLatin1StringView key)
QCborValue take(const QCborValue &key)
QCborValue take(const QString &key)
QCborValue take(qint64 key)
QCborValue toCborValue() const
QJsonObject toJsonObject() const
QVariantHash toVariantHash() const
QVariantMap toVariantMap() const
QCborValue value(const QCborValue &key) const
QCborValue value(qint64 key) const
QCborValue value(QLatin1StringView key) const
QCborValue value(const QString &key) const
(since 6.10) QCborMap &operator=(QCborMap &&other)
QCborMap &operator=(const QCborMap &other)
QCborValueRef operator[](qint64 key)
const QCborValue operator[](const QCborValue &key) const
const QCborValue operator[](qint64 key) const
QCborValueRef operator[](QLatin1StringView key)
QCborValueRef operator[](const QCborValue &key)
QCborValueRef operator[](const QString &key)
const QCborValue operator[](QLatin1StringView key) const
const QCborValue operator[](const QString &key) const

Membres publics statiques

QCborMap fromJsonObject(const QJsonObject &obj)
(since 6.3) QCborMap fromJsonObject(QJsonObject &&obj)
QCborMap fromVariantHash(const QVariantHash &hash)
QCborMap fromVariantMap(const QVariantMap &map)
bool operator!=(const QCborMap &lhs, const QCborMap &rhs)
bool operator<(const QCborMap &lhs, const QCborMap &rhs)
bool operator<=(const QCborMap &lhs, const QCborMap &rhs)
bool operator==(const QCborMap &lhs, const QCborMap &rhs)
bool operator>(const QCborMap &lhs, const QCborMap &rhs)
bool operator>=(const QCborMap &lhs, const QCborMap &rhs)

Description détaillée

Cette classe peut être utilisée pour contenir un conteneur associatif en CBOR, une carte entre une clé et un type de valeur. CBOR est le Concise Binary Object Representation, une forme très compacte d'encodage de données binaires qui est un surensemble de JSON. Il a été créé par le groupe de travail Constrained RESTful Environments (CoRE) de l'IETF, qui l'a utilisé dans de nombreuses nouvelles RFC. Il est destiné à être utilisé parallèlement au protocole CoAP.

Contrairement à JSON et QVariantMap, les clés des cartes CBOR peuvent être de n'importe quel type, et pas seulement des chaînes de caractères. C'est pourquoi QCborMap est effectivement une carte entre les clés QCborValue et les éléments de valeur QCborValue.

Cependant, pour toutes les fonctions membres qui prennent un paramètre clé, QCborMap fournit des surcharges qui fonctionneront efficacement avec des entiers et des chaînes. En fait, l'utilisation de clés entières est encouragée, car elles occupent moins d'octets à transmettre et sont plus simples à coder et à décoder. Les protocoles plus récents conçus par le groupe de travail CoRE de l'IETF pour travailler spécifiquement avec CBOR sont connus pour les utiliser.

QCborMap n'est pas trié, c'est pourquoi la recherche de clés est d'une complexité linéaire (O(n)). QCborMap conserve les éléments dans l'ordre dans lequel ils ont été insérés, ce qui signifie qu'il est possible de créer des QCborMap triées en insérant soigneusement des éléments dans l'ordre trié. CBOR n'exige pas le tri, mais le recommande.

QCborMap peut également être converti vers et depuis QVariantMap et QJsonObject. Cependant, lors de la conversion, toutes les clés qui ne sont pas des chaînes seront stringifiées à l'aide d'une méthode à sens unique que la reconversion en QCborMap n'annulera pas.

Voir aussi QCborArray, QCborValue, QJsonDocument, QVariantMap, Parsing and displaying CBOR data, Serialization Converter, and Saving and Loading a Game.

Documentation sur les types de membres

QCborMap::const_iterator

Un synonyme de QCborMap::ConstIterator

[since 6.10] QCborMap::const_key_value_iterator

Le typage QCborMap::const_key_value_iterator fournit un itérateur de style STL pour QCborMap.

QCborMap::const_key_value_iterator est essentiellement le même que QCborMap::const_iterator mais fourni pour la symétrie avec d'autres conteneurs comme QJsonObject.

Ce typedef a été introduit dans Qt 6.10.

Voir aussi QKeyValueIterator.

QCborMap::iterator

Synonyme de QCborMap::Iterator.

QCborMap::key_type

Le type de clé pour cette carte. Comme les clés QCborMap peuvent être de n'importe quel type CBOR, il s'agit d'une clé QCborValue.

[since 6.10] QCborMap::key_value_iterator

Le typage QCborMap::key_value_iterator fournit un itérateur de style STL pour QCborMap.

QCborMap::key_value_iterator est essentiellement le même que QCborMap::iterator mais fourni pour la symétrie avec d'autres conteneurs comme QJsonObject.

Ce typedef a été introduit dans Qt 6.10.

Voir aussi QKeyValueIterator.

QCborMap::mapped_type

Le type qui est mis en correspondance avec (la valeur), c'est-à-dire un QCborValue.

QCborMap::size_type

Le type utilisé par QCborMap pour les tailles.

QCborMap::value_type

La valeur qui est stockée dans ce conteneur : une paire de QCborValues

Documentation des fonctions membres

[noexcept] QCborMap::QCborMap()

Construit un objet CBOR Map vide.

Voir aussi isEmpty().

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

Construit un QCborMap avec les éléments d'une liste d'initialisation d'accolades trouvée dans 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, since 6.10] QCborMap::QCborMap(QCborMap &&other)

Constructeur de déplacement.

L'objet déplacé 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 qu'il possède.

[since 6.10] auto QCborMap::asKeyValueRange() &

[since 6.10] auto QCborMap::asKeyValueRange() const &

[since 6.10] auto QCborMap::asKeyValueRange() &&

[since 6.10] auto QCborMap::asKeyValueRange() const &&

Renvoie un objet plage qui permet d'itérer sur cette carte sous forme de paires clé/valeur.

Notez que les valeurs obtenues de cette manière sont des références à celles de la carte. Plus précisément, la modification de la valeur modifiera la carte elle-même.

Ces fonctions ont été introduites dans Qt 6.10.

Voir aussi 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 retourné sera le même que celui de end().

Voir aussi 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 retourné sera le même que celui de constEnd().

Voir aussi begin() 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 retourné sera le même que celui de constEnd().

Voir aussi 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 aussi 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 et other, en comparant chaque élément dans l'ordre, et renvoie un entier qui indique 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 les mêmes paires mais dans un ordre différent se compareront différemment. Pour éviter cela, il est recommandé d'insérer les éléments dans la carte dans un ordre prévisible, par exemple par valeur de clé ascendante. En fait, les cartes dont les clés sont triées sont nécessaires à la représentation canonique CBOR.

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 retourné sera le même que celui de constEnd().

Voir aussi 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 aussi begin(), constBegin(), find(), et constFind().

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

Renvoie un itérateur de carte 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().

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

Si la carte contient plus d'une clé égale à key, il n'est pas défini laquelle cette fonction trouvera. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR avec ces clés. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

Voir aussi 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 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 plus d'une clé égale à key, on ne sait pas laquelle cette fonction trouvera. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

Il s'agit d'une fonction surchargée.

Voir aussi 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 carte 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 plus d'une clé égale à key, on ne sait pas laquelle cette fonction trouvera. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

Il s'agit d'une fonction surchargée.

Voir aussi 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 carte 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 plus d'une clé égale à key, on ne sait pas laquelle cette fonction trouvera. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

Il s'agit d'une fonction surchargée.

Voir aussi 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 constant de style STL pointant vers la première entrée de la carte.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi keyValueBegin().

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

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

Cette fonction a été introduite dans Qt 6.10.

Voir aussi constKeyValueBegin().

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

Retourne vrai si cette carte contient une paire clé-valeur identifiée par la clé key.

Voir aussi 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

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

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

bool QCborMap::contains(QLatin1StringView key) const

Retourne vrai si cette carte contient une paire clé-valeur identifiée par la clé key.

Il s'agit d'une fonction surchargée.

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

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

Retourne vrai si cette carte contient une paire clé-valeur identifiée par la clé key.

Il s'agit d'une fonction surchargée.

Voir aussi 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.

Retourne true si cette carte 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 aussi 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 aussi begin(), constBegin(), find(), et constFind().

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

Supprime la paire clé-valeur indiquée par l'itérateur de carte it et renvoie un pointeur sur l'élément suivant, après suppression.

Voir aussi remove(), begin(), end(), insert(), et extract().

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

Supprime la paire clé-valeur indiquée par l'itérateur de carte it et renvoie un pointeur sur l'élément suivant, après suppression.

Il s'agit d'une fonction surchargée.

Voir aussi remove(), begin(), end() et insert().

QCborValue QCborMap::extract(QCborMap::iterator it)

QCborValue QCborMap::extract(QCborMap::const_iterator it)

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

Voir aussi insert(), erase(), take() et remove().

QCborMap::iterator QCborMap::find(qint64 key)

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

Renvoie un itérateur de carte 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().

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

Si la carte contient plus d'une clé égale à key, il n'est pas défini laquelle cette fonction trouvera. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR avec ces clés. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

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

QCborMap::iterator QCborMap::find(QLatin1StringView key)

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

Renvoie un itérateur de carte 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 carte contient plus d'une clé égale à key, on ne sait pas laquelle cette fonction trouvera. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

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

QCborMap::iterator QCborMap::find(const QCborValue &key)

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

Renvoie un itérateur de carte 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 carte contient plus d'une clé égale à key, on ne sait pas laquelle cette fonction trouvera. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

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

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

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

Renvoie un itérateur de carte 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 carte contient plus d'une clé égale à key, on ne sait pas laquelle cette fonction trouvera. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

Voir aussi 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 trouvés dans l'objet obj en CBOR en utilisant QCborValue::fromJson(), et renvoie la carte composée de ces éléments.

Cette conversion est sans perte, car le système de types CBOR est un surensemble de celui de JSON. De plus, la carte retournée par cette fonction peut être reconvertie au format original obj en utilisant toJsonObject().

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

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

Il s'agit d'une fonction surchargée.

Cette fonction a été introduite dans Qt 6.3.

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

Convertit tous les éléments de hash en CBOR en utilisant QCborValue::fromVariant() et renvoie la carte composée de ces éléments.

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

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

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

Convertit tous les éléments de map en CBOR en utilisant QCborValue::fromVariant() et renvoie la carte composée de ces éléments.

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

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

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

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

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

Il s'agit d'une fonction surchargée.

Voir aussi 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 sur la paire nouvellement insérée.

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

Il s'agit d'une fonction surchargée.

Voir aussi 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 sur la paire nouvellement insérée.

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

Il s'agit d'une fonction surchargée.

Voir aussi 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 sur la paire nouvellement insérée.

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

Il s'agit d'une fonction surchargée.

Voir aussi 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 sur la paire nouvellement insérée.

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

Il s'agit d'une fonction surchargée.

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

bool QCborMap::isEmpty() const

Retourne vrai si cette carte est vide (c'est-à-dire si size() vaut 0).

Voir aussi size() et clear().

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

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

Cette fonction a été introduite dans Qt 6.10.

Voir aussi keyValueEnd().

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

Renvoie un itérateur constant de style STL pointant vers la première entrée de la carte.

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 style STL pointant vers l'entrée imaginaire située après la dernière entrée de la carte.

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 constant de style STL pointant vers l'entrée imaginaire située après la dernière entrée de la carte.

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 aussi QMap::keys() et QHash::keys().

void QCborMap::remove(const QCborValue &key)

Supprime la clé key et la valeur correspondante de la carte, si elle est trouvée. Si la carte ne contient aucune clé de ce type, cette fonction ne fait rien.

Si la carte contient plus d'une clé égale à key, il n'est pas défini laquelle cette fonction supprimera. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

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

Voir aussi 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 carte, si elle est trouvée. Si la carte ne contient aucune clé de ce type, cette fonction ne fait rien.

Si la carte contient plus d'une clé égale à key, il n'est pas défini laquelle cette fonction supprimera. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

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

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

void QCborMap::remove(QLatin1StringView key)

Supprime la clé key et la valeur correspondante de la carte, si elle est trouvée. Si la carte ne contient aucune clé de ce type, cette fonction ne fait rien.

Si la carte contient plus d'une clé égale à key, il n'est pas défini laquelle cette fonction supprimera. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

Il s'agit d'une fonction surchargée.

Voir aussi 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 carte, si elle est trouvée. Si la carte ne contient aucune clé de ce type, cette fonction ne fait rien.

Si la carte contient plus d'une clé égale à key, il n'est pas défini laquelle cette fonction supprimera. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

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

Il s'agit d'une fonction surchargée.

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

[noexcept] qsizetype QCborMap::size() const

Renvoie le nombre d'éléments de cette carte.

Voir aussi isEmpty().

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

Remplace cette carte par other. Cette opération est très rapide et n'échoue jamais.

QCborValue QCborMap::take(QLatin1StringView key)

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

Si la carte contient plus d'une clé égale à key, on ne sait pas laquelle cette fonction va supprimer. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

Voir aussi 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 carte et renvoie la valeur, si elle est trouvée. Si la carte ne contient aucune clé de ce type, cette fonction ne fait rien.

Si la carte contient plus d'une clé égale à key, on ne sait pas laquelle cette fonction va supprimer. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

Voir aussi 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 carte et renvoie la valeur, si elle est trouvée. Si la carte ne contient aucune clé de ce type, cette fonction ne fait rien.

Si la carte contient plus d'une clé égale à key, on ne sait pas laquelle cette fonction va supprimer. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

Voir aussi 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 carte et renvoie la valeur, si elle est trouvée. Si la carte ne contient aucune clé de ce type, cette fonction ne fait rien.

Si la carte contient plus d'une clé égale à key, on ne sait pas laquelle cette fonction va supprimer. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

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

QCborValue QCborMap::toCborValue() const

Construit explicitement un objet QCborValue qui représente cette carte. Cette fonction n'est généralement pas nécessaire puisque QCborValue possède un constructeur pour QCborMap, la conversion est donc implicite.

La conversion de QCborMap en QCborValue permet de l'utiliser dans tous les contextes où les QCborValues peuvent être utilisées, y compris comme clés et types mappés dans QCborMap, ainsi que dans QCborValue::toCbor().

Voir aussi QCborValue::QCborValue(const QCborMap &).

QJsonObject QCborMap::toJsonObject() const

Convertit récursivement chaque valeur QCborValue de cette carte en JSON à l'aide de QCborValue::toJsonValue() et crée une clé de chaîne pour toutes les clés qui ne sont pas des chaînes, puis renvoie la valeur QJsonObject correspondante composée de ces associations.

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

Conversion d'une clé de carte en chaîne de caractères

Les objets JSON sont définis comme ayant des clés de type chaîne de caractères, contrairement à CBOR, de sorte que la conversion d'un QCborMap en QJsonObject impliquera une étape de "stringification" des valeurs de la clé. La conversion utilisera la gestion spéciale des balises et des types étendus décrite ci-dessus et convertira également le reste des types comme suit :

TypeTransformation
Bool"vrai" et "faux"
Nul"null" (nul)
Indéfini"undefined" (non défini)
EntierLa forme décimale de la chaîne de caractères du nombre
DoubleLa forme décimale de la chaîne de caractères du nombre
Tableau d'octetsSauf indication contraire (voir ci-dessus), encodé en Base64url
TableauRemplacé par la forme compacte de son Diagnostic notation
CarteRemplacé par la forme compacte de son Diagnostic notation
Balises et types étendusLe numéro de balise est supprimé et la valeur balisée est convertie en chaîne de caractères.

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

QVariantHash QCborMap::toVariantHash() const

Convertit les valeurs CBOR en QVariant à l'aide de QCborValue::toVariant() et "chaîne" toutes les clés CBOR de cette carte, en renvoyant le QVariantHash qui résulte de cette liste d'associations.

Les QVariantMaps ont des clés de type chaîne de caractères, contrairement à CBOR, de sorte que la conversion d'un QCborMap en QVariantMap impliquera une étape de "stringification" des valeurs de la clé. Voir QCborMap::toJsonObject() pour plus de détails.

En outre, la conversion vers QVariant n'est pas totalement sans perte. Veuillez consulter la documentation de QCborValue::toVariant() pour plus d'informations.

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

QVariantMap QCborMap::toVariantMap() const

Convertit les valeurs CBOR en QVariant à l'aide de QCborValue::toVariant() et "chaîne" toutes les clés CBOR de cette carte, en renvoyant le QVariantMap qui résulte de cette liste d'associations.

Les QVariantMaps ont des clés de type chaîne de caractères, contrairement à CBOR, de sorte que la conversion d'un QCborMap en QVariantMap impliquera une étape de "stringification" des valeurs de la clé. Voir QCborMap::toJsonObject() pour plus de détails.

En outre, la conversion vers QVariant n'est pas totalement sans perte. Veuillez consulter la documentation de QCborValue::toVariant() pour plus d'informations.

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

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

Renvoie l'élément QCborValue de cette carte qui correspond à la clé key, s'il y en a une.

Si la carte ne contient pas la clé key, cette fonction renvoie un QCborValue contenant une valeur non définie. C'est pourquoi cette fonction ne permet pas de distinguer la situation où la clé n'est pas présente de celle où la clé a été associée à une valeur indéfinie.

Si la carte contient plus d'une clé égale à key, on ne sait pas laquelle cette fonction renverra. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

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

Voir aussi 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 y en a une. CBOR recommande d'utiliser des clés entières, car elles occupent moins d'espace et sont plus simples à coder et à décoder.

Si la carte ne contient pas la clé key, cette fonction renvoie un QCborValue contenant une valeur non définie. C'est pourquoi cette fonction ne permet pas de distinguer la situation où la clé n'est pas présente de celle où la clé a été associée à une valeur indéfinie.

Si la carte contient plus d'une clé égale à key, il n'est pas possible de déterminer laquelle sera référencée dans le retour de la fonction. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

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

Voir aussi 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 qui correspond à la clé key, s'il y en a une.

Si la carte ne contient pas la clé key, cette fonction renvoie un QCborValue contenant une valeur non définie. C'est pourquoi cette fonction ne permet pas de distinguer la situation où la clé n'est pas présente de celle où la clé a été associée à une valeur indéfinie.

Si la carte contient plus d'une clé égale à key, on ne sait pas laquelle cette fonction renverra. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

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

Il s'agit d'une fonction surchargée.

Voir aussi 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 y en a une.

Si la carte ne contient pas la clé key, cette fonction renvoie un QCborValue contenant une valeur non définie. C'est pourquoi cette fonction ne permet pas de distinguer la situation où la clé n'est pas présente de celle où la clé a été associée à une valeur indéfinie.

Si la carte contient plus d'une clé égale à key, on ne sait pas laquelle cette fonction renverra. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

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

Il s'agit d'une fonction surchargée.

Voir aussi 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 d'affectation de déplacement.

L'objet déplacé 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 QCborValueRef à la valeur de cette carte qui correspond à la clé key. CBOR recommande d'utiliser des clés entières, car elles occupent moins d'espace et sont plus simples à coder et à décoder.

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

Si la carte n'avait pas de clé égale à key, une clé est insérée et cette fonction renvoie une référence à la nouvelle valeur, qui sera un QCborValue avec une valeur indéfinie. C'est pourquoi cette fonction ne permet pas de distinguer la situation où la clé n'était pas présente de celle où la clé a été associée à une valeur indéfinie.

Si la carte contient plus d'une clé égale à key, on ne sait pas laquelle sera référencée par le retour. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

Voir aussi 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 y en a une.

Si la carte ne contient pas la clé key, cette fonction renvoie un QCborValue contenant une valeur non définie. C'est pourquoi cette fonction ne permet pas de distinguer la situation où la clé n'est pas présente de celle où la clé a été associée à une valeur indéfinie.

Si la carte contient plus d'une clé égale à key, on ne sait pas laquelle cette fonction renverra. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

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

Voir aussi 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 y en a une. CBOR recommande d'utiliser des clés entières, car elles occupent moins d'espace et sont plus simples à coder et à décoder.

Si la carte ne contient pas la clé key, cette fonction renvoie un QCborValue contenant une valeur non définie. C'est pourquoi cette fonction ne permet pas de distinguer la situation où la clé n'est pas présente de celle où la clé a été associée à une valeur indéfinie.

Si la carte contient plus d'une clé égale à key, on ne sait pas laquelle cette fonction renverra. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

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

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

QCborValueRef QCborMap::operator[](QLatin1StringView key)

Renvoie un QCborValueRef à la valeur de cette carte qui correspond à la clé key.

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

Si la carte n'avait pas de clé égale à key, une clé est insérée et cette fonction renvoie une référence à la nouvelle valeur, qui sera un QCborValue avec une valeur indéfinie. C'est pourquoi cette fonction ne permet pas de distinguer la situation où la clé n'était pas présente de celle où la clé a été associée à une valeur indéfinie.

Si la carte contient plus d'une clé égale à key, on ne sait pas laquelle sera référencée par le retour. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

Il s'agit d'une fonction surchargée.

Voir aussi 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 QCborValueRef à la valeur de cette carte qui correspond à la clé key.

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

Si la carte n'avait pas de clé égale à key, une clé est insérée et cette fonction renvoie une référence à la nouvelle valeur, qui sera un QCborValue avec une valeur indéfinie. C'est pourquoi cette fonction ne permet pas de distinguer la situation où la clé n'était pas présente de celle où la clé a été associée à une valeur indéfinie.

Si la carte contient plus d'une clé égale à key, on ne sait pas laquelle sera référencée par le retour. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

Il s'agit d'une fonction surchargée.

Voir aussi 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 QCborValueRef à la valeur de cette carte qui correspond à la clé key.

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

Si la carte n'avait pas de clé égale à key, une clé est insérée et cette fonction renvoie une référence à la nouvelle valeur, qui sera un QCborValue avec une valeur indéfinie. C'est pourquoi cette fonction ne permet pas de distinguer la situation où la clé n'était pas présente de celle où la clé a été associée à une valeur indéfinie.

Si la carte contient plus d'une clé égale à key, on ne sait pas laquelle sera référencée par le retour. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

Il s'agit d'une fonction surchargée.

Voir aussi 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 y en a une.

Si la carte ne contient pas la clé key, cette fonction renvoie un QCborValue contenant une valeur non définie. C'est pourquoi cette fonction ne permet pas de distinguer la situation où la clé n'est pas présente de celle où la clé a été associée à une valeur indéfinie.

Si la carte contient plus d'une clé égale à key, on ne sait pas laquelle cette fonction renverra. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

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

Il s'agit d'une fonction surchargée.

Voir aussi 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 y en a une.

Si la carte ne contient pas la clé key, cette fonction renvoie un QCborValue contenant une valeur non définie. C'est pourquoi cette fonction ne permet pas de distinguer la situation où la clé n'est pas présente de celle où la clé a été associée à une valeur indéfinie.

Si la carte contient plus d'une clé égale à key, on ne sait pas laquelle cette fonction renverra. QCborMap ne permet pas d'insérer des clés dupliquées, mais il est possible de créer une telle carte en décodant un flux CBOR qui en contient. Ils ne sont généralement pas autorisés et le fait d'avoir des clés dupliquées indique généralement un problème au niveau de l'expéditeur.

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

Il s'agit d'une fonction surchargée.

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

Non-membres apparentés

[noexcept] bool operator!=(const QCborMap &lhs, const QCborMap &rhs)

Compare les cartes lhs et rhs, en comparant chaque élément dans l'ordre, et renvoie un message vrai si les deux cartes contiennent des éléments différents ou des éléments dans des ordres différents, et un message faux dans le cas contraire.

Notez que les cartes CBOR ne sont pas ordonnées, ce qui signifie que deux cartes contenant les mêmes paires mais dans un ordre différent seront comparées différemment. Pour éviter cela, il est recommandé d'insérer les éléments dans la carte dans un ordre prévisible, par exemple par valeur de clé ascendante. En fait, les cartes dont les clés sont triées sont nécessaires pour la représentation CBOR canonique.

Pour plus d'informations sur l'égalité CBOR dans Qt, voir QCborValue::compare().

Voir aussi compare(), QCborValue::operator==(), operator==(), et operator<().

[noexcept] bool operator<(const QCborMap &lhs, const QCborMap &rhs)

Compare les cartes lhs et rhs, en comparant chaque élément dans l'ordre, et renvoie true si la carte lhs doit être triée avant rhs, false dans le cas contraire.

Notez que les cartes CBOR ne sont pas ordonnées, ce qui signifie que deux cartes contenant les mêmes paires mais dans un ordre différent seront comparées différemment. Pour éviter cela, il est recommandé d'insérer les éléments dans la carte dans un ordre prévisible, par exemple par valeur de clé ascendante. En fait, les cartes dont les clés sont triées sont nécessaires à la représentation canonique CBOR.

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

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

[noexcept] bool operator<=(const QCborMap &lhs, const QCborMap &rhs)

Compare les cartes lhs et rhs, en comparant chaque élément dans l'ordre, et renvoie la valeur true si la carte lhs doit être triée avant rhs ou si les deux cartes contiennent les mêmes éléments dans le même ordre, false dans le cas contraire.

Notez que les cartes CBOR ne sont pas ordonnées, ce qui signifie que deux cartes contenant les mêmes paires mais dans un ordre différent se compareront différemment. Pour éviter cela, il est recommandé d'insérer les éléments dans la carte dans un ordre prévisible, par exemple par valeur de clé ascendante. En fait, les cartes dont les clés sont triées sont nécessaires à la représentation canonique CBOR.

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

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

[noexcept] bool operator==(const QCborMap &lhs, const QCborMap &rhs)

Compare les cartes lhs et rhs, en comparant chaque élément dans l'ordre, et renvoie true si les deux cartes contiennent les mêmes éléments dans le même ordre, false dans le cas contraire.

Notez que les cartes CBOR ne sont pas ordonnées, ce qui signifie que deux cartes contenant les mêmes paires mais dans un ordre différent se compareront différemment. Pour éviter cela, il est recommandé d'insérer les éléments dans la carte dans un ordre prévisible, par exemple par valeur de clé ascendante. En fait, les cartes dont les clés sont triées sont nécessaires pour la représentation CBOR canonique.

Pour plus d'informations sur l'égalité CBOR dans Qt, voir QCborValue::compare().

Voir aussi compare(), QCborValue::operator==(), operator!=(), et operator<().

[noexcept] bool operator>(const QCborMap &lhs, const QCborMap &rhs)

Compare les cartes lhs et rhs, en comparant chaque élément dans l'ordre, et renvoie true si la carte lhs doit être triée après rhs, false dans le cas contraire.

Notez que les cartes CBOR ne sont pas ordonnées, ce qui signifie que deux cartes contenant les mêmes paires mais dans un ordre différent seront comparées différemment. Pour éviter cela, il est recommandé d'insérer les éléments dans la carte dans un ordre prévisible, par exemple par valeur de clé ascendante. En fait, les cartes dont les clés sont triées sont nécessaires à la représentation canonique CBOR.

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

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

[noexcept] bool operator>=(const QCborMap &lhs, const QCborMap &rhs)

Compare les cartes lhs et rhs, en comparant chaque élément dans l'ordre, et renvoie la valeur true si la carte lhs doit être triée après rhs ou si les deux cartes contiennent les mêmes éléments dans le même ordre, false dans le cas contraire.

Notez que les cartes CBOR ne sont pas ordonnées, ce qui signifie que deux cartes contenant les mêmes paires mais dans un ordre différent se compareront différemment. Pour éviter cela, il est recommandé d'insérer les éléments dans la carte dans un ordre prévisible, par exemple par valeur de clé ascendante. En fait, les cartes dont les clés sont triées sont nécessaires à la représentation canonique CBOR.

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

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

© 2026 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.