QJSValueIterator Class

The QJSValueIterator class provides a Java-style iterator for QJSValue. More...

Header: #include <QJSValueIterator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Qml)
target_link_libraries(mytarget PRIVATE Qt6::Qml)
qmake: QT += qml

Public Functions

QJSValueIterator(const QJSValue &object)
~QJSValueIterator()
bool hasNext() const
QString name() const
bool next()
QJSValue value() const
QJSValueIterator &operator=(QJSValue &object)

Detailed Description

The QJSValueIterator constructor takes a QJSValue as argument. After construction, the iterator is located at the very beginning of the sequence of properties. Here's how to iterate over all the properties of a QJSValue:

QJSValue object;
...
QJSValueIterator it(object);
while (it.hasNext()) {
    it.next();
    qDebug() << it.name() << ": " << it.value().toString();
}

The next() advances the iterator. The name() and value() functions return the name and value of the last item that was jumped over.

Note that QJSValueIterator only iterates over the QJSValue's own properties; i.e. it does not follow the prototype chain. You can use a loop like this to follow the prototype chain:

QJSValue obj = ...; // the object to iterate over
while (obj.isObject()) {
    QJSValueIterator it(obj);
    while (it.hasNext()) {
        it.next();
        qDebug() << it.name();
    }
    obj = obj.prototype();
}

See also QJSValue::property().

Member Function Documentation

QJSValueIterator::QJSValueIterator(const QJSValue &object)

Constructs an iterator for traversing object. The iterator is set to be at the front of the sequence of properties (before the first property).

[noexcept] QJSValueIterator::~QJSValueIterator()

Destroys the iterator.

bool QJSValueIterator::hasNext() const

Returns true if there is at least one item ahead of the iterator (i.e. the iterator is not at the back of the property sequence); otherwise returns false.

See also next().

QString QJSValueIterator::name() const

Returns the name of the last property that was jumped over using next().

See also value().

bool QJSValueIterator::next()

Advances the iterator by one position. Returns true if there was at least one item ahead of the iterator (i.e. the iterator was not already at the back of the property sequence); otherwise returns false.

See also hasNext() and name().

QJSValue QJSValueIterator::value() const

Returns the value of the last property that was jumped over using next().

See also name().

QJSValueIterator &QJSValueIterator::operator=(QJSValue &object)

Makes the iterator operate on object. The iterator is set to be at the front of the sequence of properties (before the first property).

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