Qt
Internal/Contributor docs for the Qt SDK. <b>Note:</b> These are NOT official API docs; those are found <a href='https://doc.qt.io/'>here</a>.
|
\inmodule QtCore\reentrant More...
#include <qjsonobject.h>
Public Types | |
typedef std::random_access_iterator_tag | iterator_category |
A synonym for {std::random_access_iterator_tag} indicating this iterator is a random-access iterator. | |
typedef qsizetype | difference_type |
typedef QJsonValue | value_type |
typedef QJsonValueRef | reference |
typedef QJsonValueRef * | pointer |
Public Member Functions | |
iterator () | |
Constructs an uninitialized iterator. | |
iterator (QJsonObject *obj, qsizetype index) | |
constexpr | iterator (const iterator &other)=default |
iterator & | operator= (const iterator &other) |
QString | key () const |
Returns the current item's key. | |
QJsonValueRef | value () const |
Returns a modifiable reference to the current item's value. | |
QJsonValueRef | operator* () const |
Returns a modifiable reference to the current item's value. | |
const QJsonValueConstRef * | operator-> () const |
Returns a pointer to a constant reference to the current item. | |
QJsonValueRef * | operator-> () |
Returns a pointer to a modifiable reference to the current item. | |
QJsonValueRef | operator[] (qsizetype j) const |
Returns a modifiable reference to the item at offset j from the item pointed to by this iterator (the item at position {*this + j}). | |
iterator & | operator++ () |
The prefix {++} operator, {++i}, advances the iterator to the next item in the object and returns an iterator to the new current item. | |
iterator | operator++ (int) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.The postfix {++} operator, {i++}, advances the iterator to the next item in the object and returns an iterator to the previously current item. | |
iterator & | operator-- () |
The prefix {–} operator, {–i}, makes the preceding item current and returns an iterator pointing to the new current item. | |
iterator | operator-- (int) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.The postfix {–} operator, {i–}, makes the preceding item current and returns an iterator pointing to the previously current item. | |
iterator | operator+ (qsizetype j) const |
Returns an iterator to the item at j positions forward from this iterator. | |
iterator | operator- (qsizetype j) const |
Returns an iterator to the item at j positions backward from this iterator. | |
iterator & | operator+= (qsizetype j) |
Advances the iterator by j items. | |
iterator & | operator-= (qsizetype j) |
Makes the iterator go back by j items. | |
qsizetype | operator- (iterator j) const |
Returns the number of items between the item pointed to by other and the item pointed to by this iterator. | |
Friends | |
class | const_iterator |
class | QJsonObject |
bool | comparesEqual (const iterator &lhs, const iterator &rhs) noexcept |
Qt::strong_ordering | compareThreeWay (const iterator &lhs, const iterator &rhs) noexcept |
bool | comparesEqual (const iterator &lhs, const const_iterator &rhs) noexcept |
Qt::strong_ordering | compareThreeWay (const iterator &lhs, const const_iterator &rhs) noexcept |
\inmodule QtCore
\reentrant
The QJsonObject::iterator class provides an STL-style non-const iterator for QJsonObject.
\compares strong \compareswith strong QJsonObject::const_iterator \endcompareswith
QJsonObject::iterator allows you to iterate over a QJsonObject and to modify the value (but not the key) stored under a particular key. If you want to iterate over a const QJsonObject, you should use QJsonObject::const_iterator. It is generally good practice to use QJsonObject::const_iterator on a non-const QJsonObject as well, unless you need to change the QJsonObject through the iterator. Const iterators are slightly faster, and improve code readability.
The default QJsonObject::iterator constructor creates an uninitialized iterator. You must initialize it using a QJsonObject function like QJsonObject::begin(), QJsonObject::end(), or QJsonObject::find() before you can start iterating.
Multiple iterators can be used on the same object. Existing iterators will however become dangling once the object gets modified.
Definition at line 81 of file qjsonobject.h.
Definition at line 89 of file qjsonobject.h.
A synonym for {std::random_access_iterator_tag} indicating this iterator is a random-access iterator.
Definition at line 88 of file qjsonobject.h.
Definition at line 92 of file qjsonobject.h.
Definition at line 91 of file qjsonobject.h.
Definition at line 90 of file qjsonobject.h.
|
inline |
Constructs an uninitialized iterator.
Functions like key(), value(), and operator++() must not be called on an uninitialized iterator. Use operator=() to assign a value to it before using it.
Definition at line 94 of file qjsonobject.h.
|
inline |
Definition at line 95 of file qjsonobject.h.
|
constexprdefault |
|
inline |
Returns the current item's key.
There is no direct way of changing an item's key through an iterator, although it can be done by calling QJsonObject::erase() followed by QJsonObject::insert().
Definition at line 104 of file qjsonobject.h.
References item.
|
inline |
Returns a modifiable reference to the current item's value.
Same as value().
The return value is of type QJsonValueRef, a helper class for QJsonArray and QJsonObject. When you get an object of type QJsonValueRef, you can use it as if it were a reference to a QJsonValue. If you assign to it, the assignment will apply to the element in the QJsonArray or QJsonObject from which you got the reference.
Definition at line 106 of file qjsonobject.h.
References item.
|
inline |
Returns an iterator to the item at j positions forward from this iterator.
If j is negative, the iterator goes backward.
Definition at line 125 of file qjsonobject.h.
References j.
|
inline |
The prefix {++} operator,
{++i}, advances the iterator to the next item in the object and returns an iterator to the new current item.
Calling this function on QJsonObject::end() leads to undefined results.
Definition at line 121 of file qjsonobject.h.
References item.
|
inline |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.The postfix {++} operator,
{i++}, advances the iterator to the next item in the object and returns an iterator to the previously current item.
Definition at line 122 of file qjsonobject.h.
References item.
|
inline |
Advances the iterator by j items.
If j is negative, the iterator goes backward.
Definition at line 127 of file qjsonobject.h.
Returns the number of items between the item pointed to by other and the item pointed to by this iterator.
Definition at line 129 of file qjsonobject.h.
|
inline |
Returns an iterator to the item at j positions backward from this iterator.
If j is negative, the iterator goes forward.
Definition at line 126 of file qjsonobject.h.
References j, and operator+().
|
inline |
The prefix {–} operator,
{–i}, makes the preceding item current and returns an iterator pointing to the new current item.
Calling this function on QJsonObject::begin() leads to undefined results.
Definition at line 123 of file qjsonobject.h.
References item.
|
inline |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.The postfix {–} operator,
{i–}, makes the preceding item current and returns an iterator pointing to the previously current item.
Definition at line 124 of file qjsonobject.h.
References item.
|
inline |
Makes the iterator go back by j items.
If j is negative, the iterator goes forward.
Definition at line 128 of file qjsonobject.h.
|
inline |
Returns a pointer to a modifiable reference to the current item.
Definition at line 108 of file qjsonobject.h.
References item.
|
inline |
Returns a pointer to a constant reference to the current item.
Definition at line 107 of file qjsonobject.h.
References item.
|
inline |
Returns a modifiable reference to the item at offset j from the item pointed to by this iterator (the item at position {*this + j}).
This function is provided to make QJsonObject iterators behave like C++ pointers.
The return value is of type QJsonValueRef, a helper class for QJsonArray and QJsonObject. When you get an object of type QJsonValueRef, you can use it as if it were a reference to a QJsonValue. If you assign to it, the assignment will apply to the element in the QJsonArray or QJsonObject from which you got the reference.
Definition at line 109 of file qjsonobject.h.
References j.
|
inline |
Returns a modifiable reference to the current item's value.
You can change the value of an item by using value() on the left side of an assignment.
The return value is of type QJsonValueRef, a helper class for QJsonArray and QJsonObject. When you get an object of type QJsonValueRef, you can use it as if it were a reference to a QJsonValue. If you assign to it, the assignment will apply to the element in the QJsonArray or QJsonObject from which you got the reference.
Definition at line 105 of file qjsonobject.h.
References item.
|
friend |
Definition at line 179 of file qjsonobject.h.
Definition at line 168 of file qjsonobject.h.
|
friend |
Definition at line 183 of file qjsonobject.h.
|
friend |
Definition at line 172 of file qjsonobject.h.
|
friend |
Definition at line 83 of file qjsonobject.h.
|
friend |
Definition at line 84 of file qjsonobject.h.