\inmodule QtCore\reentrant More...

#include <qcbormap.h>

Collaboration diagram for QCborMap:

Classes
class	ConstIterator
	\inmodule QtCore More...

class	Iterator
	\inmodule QtCore\reentrant More...

Public Types
typedef std::pair< QCborValue, QCborValue >	value_type
	The value that is stored in this container: a pair of QCborValues.

typedef QCborValue	key_type
	The key type for this map.

typedef QCborValue	mapped_type
	The type that is mapped to (the value), that is, a QCborValue.

typedef qsizetype	size_type
	The type that QCborMap uses for sizes.

typedef Iterator	iterator
	A synonym for QCborMap::Iterator.

typedef ConstIterator	const_iterator
	A synonym for QCborMap::ConstIterator.

Public Member Functions
	QCborMap () noexcept
	Constructs an empty CBOR Map object.

	QCborMap (const QCborMap &other) noexcept
	Creates a QCborMap object that is a copy of other.

QCborMap &	operator= (const QCborMap &other) noexcept
	Replaces the contents of this object with a copy of other, then returns a reference to this object.

	QCborMap (std::initializer_list< value_type > args)
	Constructs a QCborMap with items from a brace-initialization list found in args, as in the following example:

	~QCborMap ()
	Destroys this QCborMap object and frees any associated resources it owns.

void	swap (QCborMap &other) noexcept
	Swaps the contents of this map and other.

QCborValue	toCborValue () const
	Explicitly constructs a \l QCborValue object that represents this map.

qsizetype	size () const noexcept Q_DECL_PURE_FUNCTION
	Returns the number of elements in this map.

bool	isEmpty () const
	Returns true if this map is empty (that is, size() is 0).

void	clear ()
	Empties this map.

QList< QCborValue >	keys () const
	Returns a list of all keys in this map.

QCborValue	value (qint64 key) const
	Returns the QCborValue element in this map that corresponds to key key, if there is one.

QCborValue	value (QLatin1StringView key) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns the QCborValue element in this map that corresponds to key key, if there is one.

QCborValue	value (const QString &key) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns the QCborValue element in this map that corresponds to key key, if there is one.

QCborValue	value (const QCborValue &key) const
	Returns the QCborValue element in this map that corresponds to key key, if there is one.

template<size_t N>
QT_ASCII_CAST_WARN const QCborValue	value (const char(&key)[N]) const

const QCborValue	operator[] (qint64 key) const
	Returns the QCborValue element in this map that corresponds to key key, if there is one.

const QCborValue	operator[] (QLatin1StringView key) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns the QCborValue element in this map that corresponds to key key, if there is one.

const QCborValue	operator[] (const QString &key) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns the QCborValue element in this map that corresponds to key key, if there is one.

const QCborValue	operator[] (const QCborValue &key) const
	Returns the QCborValue element in this map that corresponds to key key, if there is one.

template<size_t N>
QT_ASCII_CAST_WARN const QCborValue	operator[] (const char(&key)[N]) const

QCborValueRef	operator[] (qint64 key)
	Returns a QCborValueRef to the value in this map that corresponds to key key.

QCborValueRef	operator[] (QLatin1StringView key)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a QCborValueRef to the value in this map that corresponds to key key.

QCborValueRef	operator[] (const QString &key)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a QCborValueRef to the value in this map that corresponds to key key.

QCborValueRef	operator[] (const QCborValue &key)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a QCborValueRef to the value in this map that corresponds to key key.

QCborValue	take (qint64 key)
	Removes the key key and the corresponding value from the map and returns the value, if it is found.

QCborValue	take (QLatin1StringView key)
	Removes the key key and the corresponding value from the map and returns the value, if it is found.

QCborValue	take (const QString &key)
	Removes the key key and the corresponding value from the map and returns the value, if it is found.

QCborValue	take (const QCborValue &key)
	Removes the key key and the corresponding value from the map and returns the value, if it is found.

void	remove (qint64 key)
	Removes the key key and the corresponding value from the map, if it is found.

void	remove (QLatin1StringView key)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Removes the key key and the corresponding value from the map, if it is found.

void	remove (const QString &key)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Removes the key key and the corresponding value from the map, if it is found.

void	remove (const QCborValue &key)
	Removes the key key and the corresponding value from the map, if it is found.

bool	contains (qint64 key) const
	Returns true if this map contains a key-value pair identified by key key.

bool	contains (QLatin1StringView key) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns true if this map contains a key-value pair identified by key key.

bool	contains (const QString &key) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns true if this map contains a key-value pair identified by key key.

bool	contains (const QCborValue &key) const
	Returns true if this map contains a key-value pair identified by key key.

int	compare (const QCborMap &other) const noexcept Q_DECL_PURE_FUNCTION
	Compares this map and other, comparing each element in sequence, and returns an integer that indicates whether this map should be sorted prior to (if the result is negative) or after other (if the result is positive).

iterator	begin ()
	Returns a map iterator pointing to the first key-value pair of this map.

const_iterator	constBegin () const
	Returns a map iterator pointing to the first key-value pair of this map.

const_iterator	begin () const
	Returns a map iterator pointing to the first key-value pair of this map.

const_iterator	cbegin () const
	Returns a map iterator pointing to the first key-value pair of this map.

iterator	end ()
	Returns a map iterator representing an element just past the last element in the map.

const_iterator	constEnd () const
	Returns a map iterator representing an element just past the last element in the map.

const_iterator	end () const
	Returns a map iterator representing an element just past the last element in the map.

const_iterator	cend () const
	Returns a map iterator representing an element just past the last element in the map.

iterator	erase (iterator it)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Removes the key-value pair pointed to by the map iterator it and returns a pointer to the next element, after removal.

iterator	erase (const_iterator it)
	Removes the key-value pair pointed to by the map iterator it and returns a pointer to the next element, after removal.

QCborValue	extract (iterator it)

QCborValue	extract (const_iterator it)
	Extracts a value from the map at the position indicated by iterator it and returns the value so extracted.

bool	empty () const
	Synonym for isEmpty().

iterator	find (qint64 key)

iterator	find (QLatin1StringView key)

iterator	find (const QString &key)

iterator	find (const QCborValue &key)

const_iterator	constFind (qint64 key) const
	Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

const_iterator	constFind (QLatin1StringView key) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

const_iterator	constFind (const QString &key) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

const_iterator	constFind (const QCborValue &key) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

const_iterator	find (qint64 key) const
	Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

const_iterator	find (QLatin1StringView key) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

const_iterator	find (const QString &key) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

const_iterator	find (const QCborValue &key) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

iterator	insert (qint64 key, const QCborValue &value_)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Inserts the key key and value value into this map and returns a map iterator pointing to the newly inserted pair.

iterator	insert (QLatin1StringView key, const QCborValue &value_)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Inserts the key key and value value into this map and returns a map iterator pointing to the newly inserted pair.

iterator	insert (const QString &key, const QCborValue &value_)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Inserts the key key and value value into this map and returns a map iterator pointing to the newly inserted pair.

iterator	insert (const QCborValue &key, const QCborValue &value_)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Inserts the key key and value value into this map and returns a map iterator pointing to the newly inserted pair.

iterator	insert (value_type v)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Inserts the key-value pair in v into this map and returns a map iterator pointing to the newly inserted pair.

QVariantMap	toVariantMap () const
	Converts the CBOR values to QVariant using QCborValue::toVariant() and "stringifies" all the CBOR keys in this map, returning the QVariantMap that results from that association list.

QVariantHash	toVariantHash () const
	Converts the CBOR values to QVariant using QCborValue::toVariant() and "stringifies" all the CBOR keys in this map, returning the QVariantHash that results from that association list.

QJsonObject	toJsonObject () const
	Recursively converts every \l QCborValue value in this map to JSON using QCborValue::toJsonValue() and creates a string key for all keys that aren't strings, then returns the corresponding QJsonObject composed of those associations.

Static Public Member Functions
static QCborMap	fromVariantMap (const QVariantMap &map)
	Converts all the items in map to CBOR using QCborValue::fromVariant() and returns the map composed of those elements.

static QCborMap	fromVariantHash (const QVariantHash &hash)
	Converts all the items in hash to CBOR using QCborValue::fromVariant() and returns the map composed of those elements.

static QCborMap	fromJsonObject (const QJsonObject &o)
	Converts all JSON items found in the obj object to CBOR using QCborValue::fromJson(), and returns the map composed of those elements.

static QCborMap	fromJsonObject (QJsonObject &&o) noexcept
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Friends
class	QCborContainerPrivate

class	QCborValue

class	QCborValueRef

class	QJsonPrivate::Variant

Q_CORE_EXPORT Q_DECL_PURE_FUNCTION bool	comparesEqual (const QCborMap &lhs, const QCborMap &rhs) noexcept

Qt::strong_ordering	compareThreeWay (const QCborMap &lhs, const QCborMap &rhs) noexcept

bool	comparesEqual (const QCborMap &lhs, const QCborValue &rhs) noexcept

Qt::strong_ordering	compareThreeWay (const QCborMap &lhs, const QCborValue &rhs) noexcept

bool	comparesEqual (const QCborMap &lhs, const QCborValueConstRef &rhs) noexcept

Qt::strong_ordering	compareThreeWay (const QCborMap &lhs, const QCborValueConstRef &rhs) noexcept

Detailed Description

\inmodule QtCore

\reentrant

Since: 5.12

The QCborMap class is used to hold an associative container representable in CBOR.

\compares strong \compareswith strong QCborValue QCborValueConstRef \endcompareswith

This class can be used to hold an associative container in CBOR, a map between a key and a value type. CBOR is the Concise Binary Object Representation, a very compact form of binary data encoding that is a superset of JSON. It was created by the IETF Constrained RESTful Environments (CoRE) WG, which has used it in many new RFCs. It is meant to be used alongside the \l{RFC 7252}{CoAP protocol}.

Unlike JSON and \l QVariantMap, CBOR map keys can be of any type, not just strings. For that reason, QCborMap is effectively a map between QCborValue keys to QCborValue value elements.

However, for all member functions that take a key parameter, QCborMap provides overloads that will work efficiently with integers and strings. In fact, the use of integer keys is encouraged, since they occupy fewer bytes to transmit and are simpler to encode and decode. Newer protocols designed by the IETF CoRE WG to work specifically with CBOR are known to use them.

QCborMap is not sorted, because of that, searching for keys has linear complexity (O(n)). QCborMap actually keeps the elements in the order that they were inserted, which means that it is possible to make sorted QCborMaps by carefully inserting elements in sorted order. CBOR does not require sorting, but recommends it.

QCborMap can also be converted to and from QVariantMap and QJsonObject. However, when performing the conversion, any non-string keys will be stringified using a one-way method that the conversion back to QCborMap will not undo.

See also: QCborArray, QCborValue, QJsonDocument, QVariantMap, {Parsing and displaying CBOR data}, {Serialization Converter}, {Saving and Loading a Game}

Definition at line 20 of file qcbormap.h.

Member Typedef Documentation

◆ const_iterator

QCborMap::const_iterator

A synonym for QCborMap::ConstIterator.

Definition at line 313 of file qcbormap.h.

◆ iterator

QCborMap::iterator

A synonym for QCborMap::Iterator.

Definition at line 312 of file qcbormap.h.

◆ key_type

QCborMap::key_type

The key type for this map.

Since QCborMap keys can be any CBOR type, this is a QCborValue.

Definition at line 24 of file qcbormap.h.

◆ mapped_type

QCborMap::mapped_type

The type that is mapped to (the value), that is, a QCborValue.

Definition at line 25 of file qcbormap.h.

◆ size_type

QCborMap::size_type

The type that QCborMap uses for sizes.

Definition at line 26 of file qcbormap.h.

◆ value_type

QCborMap::value_type

The value that is stored in this container: a pair of QCborValues.

Definition at line 23 of file qcbormap.h.

Constructor & Destructor Documentation

◆ QCborMap() [1/3]

QCborMap::QCborMap ( )

noexcept

Constructs an empty CBOR Map object.

See also: isEmpty()

Definition at line 173 of file qcbormap.cpp.

◆ QCborMap() [2/3]

QCborMap::QCborMap ( const QCborMap & other )

noexcept

Creates a QCborMap object that is a copy of other.

Definition at line 181 of file qcbormap.cpp.

◆ QCborMap() [3/3]

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

inline

Constructs a QCborMap with items from a brace-initialization list found in args, as in the following example:

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

Definition at line 227 of file qcbormap.h.

References args, insert(), and QList< T >::size().

Here is the call graph for this function:

◆ ~QCborMap()

QCborMap::~QCborMap ( )

Destroys this QCborMap object and frees any associated resources it owns.

Definition at line 205 of file qcbormap.cpp.

Member Function Documentation

◆ begin() [1/2]

QCborMap::iterator QCborMap::begin ( )

inline

Returns a map iterator pointing to the first key-value pair of this map.

If this map is empty, the returned iterator will be the same as end().

See also: constBegin(), end()

Definition at line 314 of file qcbormap.h.

References d.

◆ begin() [2/2]

QCborMap::const_iterator QCborMap::begin ( ) const

inline

Returns a map iterator pointing to the first key-value pair of this map.

If this map is empty, the returned iterator will be the same as constEnd().

See also: begin(), constEnd()

Definition at line 316 of file qcbormap.h.

◆ cbegin()

QCborMap::const_iterator QCborMap::cbegin ( ) const

inline

Returns a map iterator pointing to the first key-value pair of this map.

If this map is empty, the returned iterator will be the same as constEnd().

See also: begin(), constEnd()

Definition at line 317 of file qcbormap.h.

◆ cend()

QCborMap::iterator QCborMap::cend ( ) const

inline

Returns a map iterator representing an element just past the last element in the map.

See also: begin(), constBegin(), find(), constFind()

Definition at line 321 of file qcbormap.h.

◆ clear()

void QCborMap::clear ( )

Empties this map.

See also: isEmpty()

Definition at line 262 of file qcbormap.cpp.

References QExplicitlySharedDataPointer< T >::reset().

Here is the call graph for this function:

◆ compare()

int QCborMap::compare ( const QCborMap & other ) const

noexcept

Compares this map and other, comparing each element in sequence, and returns an integer that indicates whether this map should be sorted prior to (if the result is negative) or after other (if the result is positive).

If this function returns 0, the two maps are equal and contain the same elements.

Note that CBOR maps are unordered, which means that two maps containing the very same pairs but in different order will still compare differently. To avoid this, it is recommended to insert elements into the map in a predictable order, such as by ascending key value. In fact, maps with keys in sorted order are required for Canonical CBOR representation.

For more information on CBOR sorting order, see QCborValue::compare().

See also: QCborValue::compare(), QCborArray::compare(), operator==()

Definition at line 1530 of file qcborvalue.cpp.

References compareContainer(), d, and other().

Here is the call graph for this function:

◆ constBegin()

QCborMap::const_iterator QCborMap::constBegin ( ) const

inline

Returns a map iterator pointing to the first key-value pair of this map.

If this map is empty, the returned iterator will be the same as constEnd().

See also: begin(), constEnd()

Definition at line 315 of file qcbormap.h.

References d.

◆ constEnd()

QCborMap::iterator QCborMap::constEnd ( ) const

inline

Returns a map iterator representing an element just past the last element in the map.

See also: begin(), constBegin(), find(), constFind()

Definition at line 319 of file qcbormap.h.

References d.

Referenced by constFind(), constFind(), constFind(), and constFind().

Here is the caller graph for this function:

◆ constFind() [1/4]

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

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

If it doesn't, this function returns constEnd().

If the map contains more than one key equal to key, it is undefined which one this function will find. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), remove(const QCborValue &), contains(const QCborValue &), value(qint64), value(QLatin1StringView), value(const QString &)

Definition at line 956 of file qcbormap.cpp.

References constEnd(), and QCborContainerPrivate::findCborMapKey().

Here is the call graph for this function:

◆ constFind() [2/4]

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

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

If it doesn't, this function returns constEnd().

If the map contains more than one key equal to key, it is undefined which one this function will find. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(const QString &), operator[](const QString &), find(const QString &), remove(const QString &), contains(const QString &), value(qint64), value(QLatin1StringView), value(const QCborValue &)

Definition at line 935 of file qcbormap.cpp.

References constEnd(), QCborContainerPrivate::findCborMapKey(), and qToStringViewIgnoringNull().

Here is the call graph for this function:

◆ constFind() [3/4]

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

Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

If it doesn't, this function returns constEnd().

CBOR recommends using integer keys, since they occupy less space and are simpler to encode and decode.

If the map contains more than one key equal to key, it is undefined which one this function will find. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(qint64), operator[](qint64), find(qint64), remove(qint64), contains(qint64), value(QLatin1StringView), value(const QString &), value(const QCborValue &)

Definition at line 893 of file qcbormap.cpp.

References constEnd(), and QCborContainerPrivate::findCborMapKey().

Referenced by find(), find(), find(), and find().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ constFind() [4/4]

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

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

If it doesn't, this function returns constEnd().

If the map contains more than one key equal to key, it is undefined which one this function will find. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), remove(QLatin1StringView), contains(QLatin1StringView), value(qint64), value(const QString &), value(const QCborValue &)

Definition at line 914 of file qcbormap.cpp.

References constEnd(), and QCborContainerPrivate::findCborMapKey().

Here is the call graph for this function:

◆ contains() [1/4]

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

inline

Returns true if this map contains a key-value pair identified by key key.

See also: value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), remove(const QCborValue &), contains(qint64), remove(QLatin1StringView), remove(const QString &)

Definition at line 299 of file qcbormap.h.

References comparesEqual(), and it.

Here is the call graph for this function:

◆ contains() [2/4]

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

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns true if this map contains a key-value pair identified by key key.

See also: value(const QString &), operator[](const QString &), find(const QString &), remove(const QString &), contains(qint64), remove(QLatin1StringView), remove(const QCborValue &)

Definition at line 297 of file qcbormap.h.

References comparesEqual(), and it.

Here is the call graph for this function:

◆ contains() [3/4]

bool QCborMap::contains ( qint64 key ) const

inline

Returns true if this map contains a key-value pair identified by key key.

CBOR recommends using integer keys, since they occupy less space and are simpler to encode and decode.

See also: value(qint64), operator[](qint64), find(qint64), remove(qint64), contains(QLatin1StringView), remove(const QString &), remove(const QCborValue &)

Definition at line 293 of file qcbormap.h.

References comparesEqual(), and it.

Referenced by QGeoServiceProviderPrivate::features(), and QGeoServiceProviderPrivate::loadMeta().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ contains() [4/4]

bool QCborMap::contains ( QLatin1StringView key ) const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns true if this map contains a key-value pair identified by key key.

See also: value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), remove(QLatin1StringView), contains(qint64), remove(const QString &), remove(const QCborValue &)

Definition at line 295 of file qcbormap.h.

References comparesEqual(), and it.

Here is the call graph for this function:

◆ empty()

bool QCborMap::empty ( ) const

inline

Synonym for isEmpty().

This function is provided for compatibility with generic code that uses the Standard Library API.

Returns true if this map is empty (size() == 0).

See also: isEmpty(), size()

Definition at line 326 of file qcbormap.h.

◆ end() [1/2]

QCborMap::iterator QCborMap::end ( )

inline

Returns a map iterator representing an element just past the last element in the map.

See also: begin(), constBegin(), find(), constFind()

Definition at line 318 of file qcbormap.h.

References d.

Referenced by getRevision().

Here is the caller graph for this function:

◆ end() [2/2]

QCborMap::iterator QCborMap::end ( ) const

inline

Returns a map iterator representing an element just past the last element in the map.

See also: begin(), constBegin(), find(), constFind()

Definition at line 320 of file qcbormap.h.

◆ erase() [1/2]

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

inline

Removes the key-value pair pointed to by the map iterator it and returns a pointer to the next element, after removal.

See also: remove(), begin(), end(), insert(), extract()

Definition at line 323 of file qcbormap.h.

References erase(), and it.

Referenced by erase().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ erase() [2/2]

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

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Removes the key-value pair pointed to by the map iterator it and returns a pointer to the next element, after removal.

See also: remove(), begin(), end(), insert()

Definition at line 1048 of file qcbormap.cpp.

References it, and QCborContainerPrivate::removeAt().

Here is the call graph for this function:

◆ extract() [1/2]

QCborValue QCborMap::extract ( const_iterator it )

inline

Extracts a value from the map at the position indicated by iterator it and returns the value so extracted.

See also: insert(), erase(), take(), remove()

Definition at line 325 of file qcbormap.h.

References extract(), and it.

Referenced by extract().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ extract() [2/2]

QCborValue QCborMap::extract ( iterator it )

Definition at line 1068 of file qcbormap.cpp.

References QCborContainerPrivate::extractAt(), it, and QCborContainerPrivate::removeAt().

Here is the call graph for this function:

◆ find() [1/8]

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

Definition at line 870 of file qcbormap.cpp.

References constFind(), QExplicitlySharedDataPointer< T >::data(), and it.

Here is the call graph for this function:

◆ find() [2/8]

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

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

If it doesn't, this function returns end().

If the map contains more than one key equal to key, it is undefined which one this function will find. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(const QCborValue &), operator[](const QCborValue &), constFind(const QCborValue &), remove(const QCborValue &), contains(const QCborValue &), value(qint64), value(QLatin1StringView), value(const QString &)

Definition at line 339 of file qcbormap.h.

◆ find() [3/8]

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

Definition at line 845 of file qcbormap.cpp.

References constFind(), QExplicitlySharedDataPointer< T >::data(), and it.

Here is the call graph for this function:

◆ find() [4/8]

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

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

If it doesn't, this function returns end().

If the map contains more than one key equal to key, it is undefined which one this function will find. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(const QString &), operator[](const QString &), constFind(const QString &), remove(const QString &), contains(const QString &), value(qint64), value(QLatin1StringView), value(const QCborValue &)

Definition at line 338 of file qcbormap.h.

◆ find() [5/8]

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

Definition at line 795 of file qcbormap.cpp.

References constFind(), QExplicitlySharedDataPointer< T >::data(), and it.

Referenced by getRevision().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ find() [6/8]

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

inline

Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

If it doesn't, this function returns end().

CBOR recommends using integer keys, since they occupy less space and are simpler to encode and decode.

If the map contains more than one key equal to key, it is undefined which one this function will find. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(qint64), operator[](qint64), constFind(qint64), remove(qint64), contains(qint64), value(QLatin1StringView), value(const QString &), value(const QCborValue &)

Definition at line 336 of file qcbormap.h.

◆ find() [7/8]

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

Definition at line 820 of file qcbormap.cpp.

References constFind(), QExplicitlySharedDataPointer< T >::data(), and it.

Here is the call graph for this function:

◆ find() [8/8]

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

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a map iterator to the key-value pair whose key is key, if the map contains such a pair.

If it doesn't, this function returns end().

If the map contains more than one key equal to key, it is undefined which one this function will find. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(QLatin1StringView), operator[](QLatin1StringView), constFind(QLatin1StringView), remove(QLatin1StringView), contains(QLatin1StringView), value(qint64), value(const QString &), value(const QCborValue &)

Definition at line 337 of file qcbormap.h.

◆ fromJsonObject() [1/2]

QCborMap QCborMap::fromJsonObject ( const QJsonObject & obj )

static

Converts all JSON items found in the obj object to CBOR using QCborValue::fromJson(), and returns the map composed of those elements.

This conversion is lossless, as the CBOR type system is a superset of JSON's. Moreover, the map returned by this function can be converted back to the original obj by using toJsonObject().

See also: toJsonObject(), toVariantMap(), QCborValue::fromJsonValue(), QCborArray::fromJsonArray()

Definition at line 980 of file qjsoncbor.cpp.

Referenced by QCborValue::fromJsonValue(), QCborValue::fromVariant(), QJsonObject::toVariantHash(), and QJsonObject::toVariantMap().

Here is the caller graph for this function:

◆ fromJsonObject() [2/2]

QCborMap QCborMap::fromJsonObject ( QJsonObject && obj )

staticnoexcept

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Since: 6.3

Definition at line 991 of file qjsoncbor.cpp.

◆ fromVariantHash()

QCborMap QCborMap::fromVariantHash ( const QVariantHash & hash )

static

Converts all the items in hash to CBOR using QCborValue::fromVariant() and returns the map composed of those elements.

Conversion from \l QVariant is not completely lossless. Please see the documentation in QCborValue::fromVariant() for more information.

See also: toVariantHash(), fromVariantMap(), fromJsonObject(), QCborValue::fromVariant()

Definition at line 954 of file qjsoncbor.cpp.

References appendVariant(), d, QCborContainerPrivate::data, hash, and it.

Referenced by QCborValue::fromVariant().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fromVariantMap()

QCborMap QCborMap::fromVariantMap ( const QVariantMap & map )

static

Converts all the items in map to CBOR using QCborValue::fromVariant() and returns the map composed of those elements.

Conversion from \l QVariant is not completely lossless. Please see the documentation in QCborValue::fromVariant() for more information.

See also: toVariantMap(), fromVariantHash(), fromJsonObject(), QCborValue::fromVariant()

Definition at line 930 of file qjsoncbor.cpp.

References appendVariant(), QMap< Key, T >::begin(), d, QCborContainerPrivate::data, QMap< Key, T >::end(), it, map, and QMap< Key, T >::size().

Referenced by QCborValue::fromVariant(), and QJsonPrivate::Variant::toJsonObject().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ insert() [1/5]

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

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Inserts the key key and value value into this map and returns a map iterator pointing to the newly inserted pair.

If the map already had a key equal to key, its value will be overwritten by value.

See also: erase(), remove(const QCborValue &), value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), contains(const QCborValue &), take(const QCborValue &), extract()

Definition at line 359 of file qcbormap.h.

References d.

◆ insert() [2/5]

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

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Inserts the key key and value value into this map and returns a map iterator pointing to the newly inserted pair.

If the map already had a key equal to key, its value will be overwritten by value.

See also: erase(), remove(const QString &), value(const QString &), operator[](const QString &), find(const QString &), contains(const QString &), take(const QString &), extract()

Definition at line 353 of file qcbormap.h.

References d.

◆ insert() [3/5]

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

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Inserts the key key and value value into this map and returns a map iterator pointing to the newly inserted pair.

If the map already had a key equal to key, its value will be overwritten by value.

See also: erase(), remove(qint64), value(qint64), operator[](qint64), find(qint64), contains(qint64), take(qint64), extract()

Definition at line 341 of file qcbormap.h.

References d.

Referenced by QGeoServiceProviderPrivate::QGeoServiceProviderPrivate(), QGeoServiceProviderPrivate::loadMeta(), and QGeoServiceProviderPrivate::unload().

Here is the caller graph for this function:

◆ insert() [4/5]

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

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Inserts the key key and value value into this map and returns a map iterator pointing to the newly inserted pair.

If the map already had a key equal to key, its value will be overwritten by value.

See also: erase(), remove(QLatin1StringView), value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), take(QLatin1StringView), extract()

Definition at line 347 of file qcbormap.h.

References d.

◆ insert() [5/5]

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

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Inserts the key-value pair in v into this map and returns a map iterator pointing to the newly inserted pair.

If the map already had a key equal to {v.first}, its value will be overwritten by {v.second}.

See also: operator[], erase(), extract()

Definition at line 365 of file qcbormap.h.

References insert().

Referenced by insert().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isEmpty()

bool QCborMap::isEmpty ( ) const

inline

Returns true if this map is empty (that is, size() is 0).

See also: size(), clear()

Definition at line 244 of file qcbormap.h.

◆ keys()

QList< QCborValue > QCborMap::keys ( ) const

Returns a list of all keys in this map.

See also: QMap::keys(), QHash::keys()

Definition at line 272 of file qcbormap.cpp.

References QCborContainerPrivate::elements, i, QList< T >::size(), and QCborContainerPrivate::valueAt().

Here is the call graph for this function:

◆ operator=()

QCborMap & QCborMap::operator= ( const QCborMap & other )

noexcept

Replaces the contents of this object with a copy of other, then returns a reference to this object.

Definition at line 213 of file qcbormap.cpp.

References d, and other().

Here is the call graph for this function:

◆ operator[]() [1/9]

template<size_t N>

QT_ASCII_CAST_WARN const QCborValue QCborMap::operator[] ( const char(&) key[N] ) const

inline

Definition at line 269 of file qcbormap.h.

References QString::fromUtf8().

Here is the call graph for this function:

◆ operator[]() [2/9]

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

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a QCborValueRef to the value in this map that corresponds to key key.

QCborValueRef has the exact same API as \l QCborValue, with one important difference: if you assign new values to it, this map will be updated with that new value.

If the map did not have a key equal to key, one is inserted and this function returns a reference to the new value, which will be a QCborValue with an undefined value. For that reason, it is not possible with this function to tell apart the situation where the key was not present from the situation where the key was mapped to an undefined value.

If the map contains more than one key equal to key, it is undefined which one the return will reference. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(const QCborValue &), find(const QCborValue &), contains(const QCborValue &), remove(const QCborValue &), operator[](qint64), operator[](QLatin1StringView), operator[](const QString &)

Definition at line 763 of file qcbormap.cpp.

◆ operator[]() [3/9]

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

inline

Returns the QCborValue element in this map that corresponds to key key, if there is one.

If the map does not contain key key, this function returns a QCborValue containing an undefined value. For that reason, it is not possible with this function to tell apart the situation where the key was not present from the situation where the key was mapped to an undefined value.

If the map contains more than one key equal to key, it is undefined which one this function will return. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(const QCborValue &), find(const QCborValue &), constFind(const QCborValue &), remove(const QCborValue &), contains(const QCborValue &) operator[](qint64), operator[](QLatin1StringView), operator[](const QCborOperator[] &)

Definition at line 266 of file qcbormap.h.

References comparesEqual(), it, and QCborValue().

Here is the call graph for this function:

◆ operator[]() [4/9]

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

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a QCborValueRef to the value in this map that corresponds to key key.

QCborValueRef has the exact same API as \l QCborValue, with one important difference: if you assign new values to it, this map will be updated with that new value.

If the map did not have a key equal to key, one is inserted and this function returns a reference to the new value, which will be a QCborValue with an undefined value. For that reason, it is not possible with this function to tell apart the situation where the key was not present from the situation where the key was mapped to an undefined value.

If the map contains more than one key equal to key, it is undefined which one the return will reference. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(const QString &), find(const QString &), contains(const QString &), remove(const QString &), operator[](qint64), operator[](QLatin1StringView), operator[](const QCborValue &)

Definition at line 643 of file qcbormap.cpp.

References QCborContainerPrivate::findOrAddMapKey(), and qToStringViewIgnoringNull().

Here is the call graph for this function:

◆ operator[]() [5/9]

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

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns the QCborValue element in this map that corresponds to key key, if there is one.

If the map does not contain key key, this function returns a QCborValue containing an undefined value. For that reason, it is not possible with this function to tell apart the situation where the key was not present from the situation where the key was mapped to an undefined value.

If the map contains more than one key equal to key, it is undefined which one this function will return. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(const QString &), find(const QString &), constFind(const QString &), remove(const QString &), contains(const QString &) operator[](qint64), operator[](QLatin1StringView), operator[](const QCborOperator[] &)

Definition at line 264 of file qcbormap.h.

References comparesEqual(), it, and QCborValue().

Here is the call graph for this function:

◆ operator[]() [6/9]

QCborValueRef QCborMap::operator[] ( qint64 key )

Returns a QCborValueRef to the value in this map that corresponds to key key.

CBOR recommends using integer keys, since they occupy less space and are simpler to encode and decode.

QCborValueRef has the exact same API as \l QCborValue, with one important difference: if you assign new values to it, this map will be updated with that new value.

If the map did not have a key equal to key, one is inserted and this function returns a reference to the new value, which will be a QCborValue with an undefined value. For that reason, it is not possible with this function to tell apart the situation where the key was not present from the situation where the key was mapped to an undefined value.

If the map contains more than one key equal to key, it is undefined which one the return will reference. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(qint64), find(qint64), contains(qint64), remove(qint64), operator[](QLatin1StringView), operator[](const QString &), operator[](const QCborValue &)

Definition at line 395 of file qcbormap.cpp.

References QCborContainerPrivate::findOrAddMapKey().

Here is the call graph for this function:

◆ operator[]() [7/9]

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

inline

Returns the QCborValue element in this map that corresponds to key key, if there is one.

CBOR recommends using integer keys, since they occupy less space and are simpler to encode and decode.

If the map does not contain key key, this function returns a QCborValue containing an undefined value. For that reason, it is not possible with this function to tell apart the situation where the key was not present from the situation where the key was mapped to an undefined value.

If the map contains more than one key equal to key, it is undefined which one this function will return. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(qint64), find(qint64), constFind(qint64), remove(qint64), contains(qint64) operator[](QLatin1StringView), operator[](const QString &), operator[](const QCborOperator[] &)

Definition at line 260 of file qcbormap.h.

References comparesEqual(), it, and QCborValue().

Here is the call graph for this function:

◆ operator[]() [8/9]

QCborValueRef QCborMap::operator[] ( QLatin1StringView key )

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns a QCborValueRef to the value in this map that corresponds to key key.

QCborValueRef has the exact same API as \l QCborValue, with one important difference: if you assign new values to it, this map will be updated with that new value.

If the map did not have a key equal to key, one is inserted and this function returns a reference to the new value, which will be a QCborValue with an undefined value. For that reason, it is not possible with this function to tell apart the situation where the key was not present from the situation where the key was mapped to an undefined value.

If the map contains more than one key equal to key, it is undefined which one the return will reference. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), remove(QLatin1StringView), operator[](qint64), operator[](const QString &), operator[](const QCborValue &)

Definition at line 519 of file qcbormap.cpp.

References QCborContainerPrivate::findOrAddMapKey().

Here is the call graph for this function:

◆ operator[]() [9/9]

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

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns the QCborValue element in this map that corresponds to key key, if there is one.

If the map does not contain key key, this function returns a QCborValue containing an undefined value. For that reason, it is not possible with this function to tell apart the situation where the key was not present from the situation where the key was mapped to an undefined value.

If the map contains more than one key equal to key, it is undefined which one this function will return. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(QLatin1StringView), find(QLatin1StringView), constFind(QLatin1StringView), remove(QLatin1StringView), contains(QLatin1StringView) operator[](qint64), operator[](const QString &), operator[](const QCborOperator[] &)

Definition at line 262 of file qcbormap.h.

References comparesEqual(), it, and QCborValue().

Here is the call graph for this function:

◆ remove() [1/4]

void QCborMap::remove ( const QCborValue & key )

inline

Removes the key key and the corresponding value from the map, if it is found.

If the map contains no such key, this function does nothing.

If the map contains more than one key equal to key, it is undefined which one this function will remove. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), contains(const QCborValue &) remove(qint64), remove(QLatin1StringView), remove(const QString &)

Definition at line 291 of file qcbormap.h.

References comparesEqual(), erase(), and it.

Here is the call graph for this function:

◆ remove() [2/4]

void QCborMap::remove ( const QString & key )

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Removes the key key and the corresponding value from the map, if it is found.

If the map contains no such key, this function does nothing.

If the map contains more than one key equal to key, it is undefined which one this function will remove. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(const QString &), operator[](const QString &), find(const QString &), contains(const QString &) remove(qint64), remove(QLatin1StringView), remove(const QCborValue &)

Definition at line 289 of file qcbormap.h.

References comparesEqual(), erase(), and it.

Here is the call graph for this function:

◆ remove() [3/4]

void QCborMap::remove ( qint64 key )

inline

Removes the key key and the corresponding value from the map, if it is found.

If the map contains no such key, this function does nothing.

If the map contains more than one key equal to key, it is undefined which one this function will remove. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(qint64), operator[](qint64), find(qint64), contains(qint64) remove(QLatin1StringView), remove(const QString &), remove(const QCborValue &)

Definition at line 285 of file qcbormap.h.

References comparesEqual(), erase(), and it.

Here is the call graph for this function:

◆ remove() [4/4]

void QCborMap::remove ( QLatin1StringView key )

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Removes the key key and the corresponding value from the map, if it is found.

If the map contains no such key, this function does nothing.

If the map contains more than one key equal to key, it is undefined which one this function will remove. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), remove(qint64), remove(const QString &), remove(const QCborValue &)

Definition at line 287 of file qcbormap.h.

References comparesEqual(), erase(), and it.

Here is the call graph for this function:

◆ size()

qsizetype QCborMap::size ( ) const

noexcept

Returns the number of elements in this map.

See also: isEmpty()

Definition at line 252 of file qcbormap.cpp.

References QCborContainerPrivate::elements, and QList< T >::size().

Here is the call graph for this function:

◆ swap()

void QCborMap::swap ( QCborMap & other )

inlinenoexcept

Swaps the contents of this map and other.

Definition at line 236 of file qcbormap.h.

References d, and other().

Here is the call graph for this function:

◆ take() [1/4]

QCborValue QCborMap::take ( const QCborValue & key )

inline

Removes the key key and the corresponding value from the map and returns the value, if it is found.

If the map contains no such key, this function does nothing.

If the map contains more than one key equal to key, it is undefined which one this function will remove. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), contains(const QCborValue &), take(QLatin1StringView), take(const QString &), take(qint64), insert()

Definition at line 283 of file qcbormap.h.

References comparesEqual(), it, and QCborValue().

Here is the call graph for this function:

◆ take() [2/4]

QCborValue QCborMap::take ( const QString & key )

inline

Removes the key key and the corresponding value from the map and returns the value, if it is found.

If the map contains no such key, this function does nothing.

If the map contains more than one key equal to key, it is undefined which one this function will remove. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(const QString &), operator[](const QString &), find(const QString &), contains(const QString &), take(QLatin1StringView), take(qint64), take(const QCborValue &), insert()

Definition at line 281 of file qcbormap.h.

References comparesEqual(), it, and QCborValue().

Here is the call graph for this function:

◆ take() [3/4]

QCborValue QCborMap::take ( qint64 key )

inline

Removes the key key and the corresponding value from the map and returns the value, if it is found.

If the map contains no such key, this function does nothing.

If the map contains more than one key equal to key, it is undefined which one this function will remove. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(qint64), operator[](qint64), find(qint64), contains(qint64), take(QLatin1StringView), take(const QString &), take(const QCborValue &), insert()

Definition at line 277 of file qcbormap.h.

References comparesEqual(), it, and QCborValue().

Here is the call graph for this function:

◆ take() [4/4]

QCborValue QCborMap::take ( QLatin1StringView key )

inline

Removes the key key and the corresponding value from the map and returns the value, if it is found.

If the map contains no such key, this function does nothing.

If the map contains more than one key equal to key, it is undefined which one this function will remove. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), take(qint64), take(const QString &), take(const QCborValue &), insert()

Definition at line 279 of file qcbormap.h.

References comparesEqual(), it, and QCborValue().

Here is the call graph for this function:

◆ toCborValue()

QCborValue QCborMap::toCborValue ( ) const

inline

Explicitly constructs a \l QCborValue object that represents this map.

This function is usually not necessary since QCborValue has a constructor for QCborMap, so the conversion is implicit.

Converting QCborMap to QCborValue allows it to be used in any context where QCborValues can be used, including as keys and mapped types in QCborMap, as well as QCborValue::toCbor().

See also: QCborValue::QCborValue(const QCborMap &)

Definition at line 241 of file qcbormap.h.

◆ toJsonObject()

QJsonObject QCborMap::toJsonObject ( ) const

Recursively converts every \l QCborValue value in this map to JSON using QCborValue::toJsonValue() and creates a string key for all keys that aren't strings, then returns the corresponding QJsonObject composed of those associations.

Please note that CBOR contains a richer and wider type set than JSON, so some information may be lost in this conversion. For more details on what conversions are applied, see QCborValue::toJsonValue().

Definition at line 469 of file qjsoncbor.cpp.

References convertToJsonObject(), and d.

Here is the call graph for this function:

◆ toVariantHash()

QVariantHash QCborMap::toVariantHash ( ) const

Converts the CBOR values to QVariant using QCborValue::toVariant() and "stringifies" all the CBOR keys in this map, returning the QVariantHash that results from that association list.

QVariantMaps have string keys, unlike CBOR, so the conversion of a QCborMap to QVariantMap will imply a step of "stringification" of the key values. See QCborMap::toJsonObject() for details.

In addition, the conversion to \l QVariant is not completely lossless. Please see the documentation in QCborValue::toVariant() for more information.

See also: fromVariantHash(), toVariantMap(), toJsonObject(), QCborValue::toVariant(), QCborArray::toVariantList()

Definition at line 912 of file qjsoncbor.cpp.

References d, i, makeString(), and QHash< Key, T >::reserve().

Here is the call graph for this function:

◆ toVariantMap()

QVariantMap QCborMap::toVariantMap ( ) const

Converts the CBOR values to QVariant using QCborValue::toVariant() and "stringifies" all the CBOR keys in this map, returning the QVariantMap that results from that association list.

QVariantMaps have string keys, unlike CBOR, so the conversion of a QCborMap to QVariantMap will imply a step of "stringification" of the key values. See QCborMap::toJsonObject() for details.

In addition, the conversion to \l QVariant is not completely lossless. Please see the documentation in QCborValue::toVariant() for more information.

See also: fromVariantMap(), toVariantHash(), toJsonObject(), QCborValue::toVariant(), QCborArray::toVariantList()

Definition at line 888 of file qjsoncbor.cpp.

References d, i, QMap< Key, T >::insert(), and makeString().

Here is the call graph for this function:

◆ value() [1/5]

template<size_t N>

QT_ASCII_CAST_WARN const QCborValue QCborMap::value ( const char(&) key[N] ) const

inline

Definition at line 257 of file qcbormap.h.

References QString::fromUtf8().

Here is the call graph for this function:

◆ value() [2/5]

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

inline

Returns the QCborValue element in this map that corresponds to key key, if there is one.

If the map does not contain key key, this function returns a QCborValue containing an undefined value. For that reason, it is not possible with this function to tell apart the situation where the key was not present from the situation where the key was mapped to an undefined value.

If the map contains more than one key equal to key, it is undefined which one this function will return. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: operator[](const QCborValue &), find(const QCborValue &), constFind(const QCborValue &), remove(const QCborValue &), contains(const QCborValue &) value(qint64), value(QLatin1StringView), value(const QString &)

Definition at line 254 of file qcbormap.h.

References comparesEqual(), it, and QCborValue().

Here is the call graph for this function:

◆ value() [3/5]

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

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns the QCborValue element in this map that corresponds to key key, if there is one.

If the map does not contain key key, this function returns a QCborValue containing an undefined value. For that reason, it is not possible with this function to tell apart the situation where the key was not present from the situation where the key was mapped to an undefined value.

If the map contains more than one key equal to key, it is undefined which one this function will return. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: operator[](const QString &), find(const QString &), constFind(const QString &), remove(const QString &), contains(const QString &) value(qint64), value(QLatin1StringView), value(const QCborValue &)

Definition at line 252 of file qcbormap.h.

References comparesEqual(), it, and QCborValue().

Here is the call graph for this function:

◆ value() [4/5]

QCborValue QCborMap::value ( qint64 key ) const

inline

Returns the QCborValue element in this map that corresponds to key key, if there is one.

CBOR recommends using integer keys, since they occupy less space and are simpler to encode and decode.

If the map does not contain key key, this function returns a QCborValue containing an undefined value. For that reason, it is not possible with this function to tell apart the situation where the key was not present from the situation where the key was mapped to an undefined value.

If the map contains more than one key equal to key, it is undefined which one the return from function will reference. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: operator[](qint64), find(qint64), constFind(qint64), remove(qint64), contains(qint64) value(QLatin1StringView), value(const QString &), value(const QCborValue &)

Definition at line 248 of file qcbormap.h.

References comparesEqual(), it, and QCborValue().

Referenced by QImageReaderWriterHelpers::appendImagePluginMimeTypes(), QGeoPositionInfoSourcePrivate::createSourceReal(), QGeoSatelliteInfoSourcePrivate::createSourceReal(), QGeoServiceProviderPrivate::features(), QGeoPositionInfoSourcePrivate::loadFactory(), QGeoServiceProviderPrivate::loadMeta(), QGeoServiceProviderPrivate::loadPlugin(), and QGeoServiceProviderPrivate::manager().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ value() [5/5]

QCborValue QCborMap::value ( QLatin1StringView key ) const

inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Returns the QCborValue element in this map that corresponds to key key, if there is one.

If the map does not contain key key, this function returns a QCborValue containing an undefined value. For that reason, it is not possible with this function to tell apart the situation where the key was not present from the situation where the key was mapped to an undefined value.

If the map contains more than one key equal to key, it is undefined which one this function will return. QCborMap does not allow inserting duplicate keys, but it is possible to create such a map by decoding a CBOR stream with them. They are usually not permitted and having duplicate keys is usually an indication of a problem in the sender.

See also: operator[](QLatin1StringView), find(QLatin1StringView), constFind(QLatin1StringView), remove(QLatin1StringView), contains(QLatin1StringView) value(qint64), value(const QString &), value(const QCborValue &)

Definition at line 250 of file qcbormap.h.

References comparesEqual(), it, and QCborValue().

Here is the call graph for this function:

Friends And Related Symbol Documentation

◆ comparesEqual [1/3]

Q_CORE_EXPORT Q_DECL_PURE_FUNCTION bool comparesEqual	(	const QCborMap &	lhs,
		const QCborMap &	rhs )

friend

Definition at line 1525 of file qcborvalue.cpp.

◆ comparesEqual [2/3]

bool comparesEqual	(	const QCborMap &	lhs,
		const QCborValue &	rhs )

friend

Definition at line 396 of file qcbormap.h.

◆ comparesEqual [3/3]

bool comparesEqual	(	const QCborMap &	lhs,
		const QCborValueConstRef &	rhs )

friend

Definition at line 412 of file qcbormap.h.

◆ compareThreeWay [1/3]

Qt::strong_ordering compareThreeWay	(	const QCborMap &	lhs,
		const QCborMap &	rhs )

friend

Definition at line 384 of file qcbormap.h.

◆ compareThreeWay [2/3]

Qt::strong_ordering compareThreeWay	(	const QCborMap &	lhs,
		const QCborValue &	rhs )

friend

Definition at line 401 of file qcbormap.h.

◆ compareThreeWay [3/3]

Qt::strong_ordering compareThreeWay	(	const QCborMap &	lhs,
		const QCborValueConstRef &	rhs )

friend

Definition at line 417 of file qcbormap.h.

◆ QCborContainerPrivate

friend class QCborContainerPrivate

friend

Definition at line 376 of file qcbormap.h.

◆ QCborValue

friend class QCborValue

friend

Definition at line 377 of file qcbormap.h.

◆ QCborValueRef

friend class QCborValueRef

friend

Definition at line 378 of file qcbormap.h.

◆ QJsonPrivate::Variant

friend class QJsonPrivate::Variant

friend

Definition at line 379 of file qcbormap.h.

The documentation for this class was generated from the following files:

qtbase/src/corelib/serialization/qcbormap.h (92cc21b389aa6e7223ba94daa249092bbac460dc)
qtbase/src/corelib/serialization/qcbormap.cpp (92cc21b389aa6e7223ba94daa249092bbac460dc)
qtbase/src/corelib/serialization/qcborvalue.cpp (a7b9ec7f6f465ce0d90edfe7154a4837b1fb9c00)
qtbase/src/corelib/serialization/qjsoncbor.cpp (cdbc76360ae4c12b25923a7cb392355a6485fc70)

Classes

Public Types

Public Member Functions

Static Public Member Functions

Friends

Detailed Description

Member Typedef Documentation

◆ const_iterator

◆ iterator

◆ key_type

◆ mapped_type

◆ size_type

◆ value_type

Constructor & Destructor Documentation

◆ QCborMap() [1/3]

◆ QCborMap() [2/3]

◆ QCborMap() [3/3]

◆ ~QCborMap()

Member Function Documentation

◆ begin() [1/2]

◆ begin() [2/2]

◆ cbegin()

◆ cend()

◆ clear()

◆ compare()

◆ constBegin()

◆ constEnd()

◆ constFind() [1/4]

◆ constFind() [2/4]

◆ constFind() [3/4]

◆ constFind() [4/4]

◆ contains() [1/4]

◆ contains() [2/4]

◆ contains() [3/4]

◆ contains() [4/4]

◆ empty()

◆ end() [1/2]

◆ end() [2/2]

◆ erase() [1/2]

◆ erase() [2/2]

◆ extract() [1/2]

◆ extract() [2/2]

◆ find() [1/8]

◆ find() [2/8]

◆ find() [3/8]

◆ find() [4/8]

◆ find() [5/8]

◆ find() [6/8]

◆ find() [7/8]

◆ find() [8/8]

◆ fromJsonObject() [1/2]

◆ fromJsonObject() [2/2]

◆ fromVariantHash()

◆ fromVariantMap()

◆ insert() [1/5]

◆ insert() [2/5]

◆ insert() [3/5]

◆ insert() [4/5]

◆ insert() [5/5]

◆ isEmpty()

◆ keys()

◆ operator=()

◆ operator[]() [1/9]

◆ operator[]() [2/9]

◆ operator[]() [3/9]

◆ operator[]() [4/9]

◆ operator[]() [5/9]

◆ operator[]() [6/9]

◆ operator[]() [7/9]

◆ operator[]() [8/9]

◆ operator[]() [9/9]

◆ remove() [1/4]

◆ remove() [2/4]

◆ remove() [3/4]

◆ remove() [4/4]

◆ size()

◆ swap()

◆ take() [1/4]

◆ take() [2/4]

◆ take() [3/4]