QIterator Struct
template <typename Container> struct QIteratorThe QIterator is a template class that allows iteration over a container in a QVariant. More...
Header: | #include <QIterator> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
qmake: | QT += core |
Since: | Qt 6.0 |
Inherits: | QBaseIterator |
Public Functions
QIterator(QIterable<Container> *iterable, void *iterator) | |
bool | operator!=(const QIterator<Container> &other) const |
QIterator<Container> | operator+(qsizetype j) const |
QIterator<Container> & | operator++() |
QIterator<Container> | operator++(int) |
QIterator<Container> & | operator+=(qsizetype j) |
QIterator<Container> | operator-(qsizetype j) const |
qsizetype | operator-(const QIterator<Container> &j) const |
QIterator<Container> & | operator--() |
QIterator<Container> | operator--(int) |
QIterator<Container> & | operator-=(qsizetype j) |
bool | operator==(const QIterator<Container> &other) const |
Related Non-Members
QIterator<Container> | operator+(qsizetype j, const QIterator<Container> &k) |
Detailed Description
A QIterator can only be created by a QIterable instance, and can be used in a way similar to other stl-style iterators. Generally, QIterator should not be used directly, but through its derived classes provided by QSequentialIterable and QAssociativeIterable.
See also QIterable.
Member Function Documentation
[explicit]
QIterator::QIterator(QIterable<Container> *iterable, void *iterator)
Creates an iterator from an iterable and a pointer to a native iterator.
bool QIterator::operator!=(const QIterator<Container> &other) const
Returns true
if other points to a different item than this iterator; otherwise returns false
.
See also operator==().
QIterator<Container> QIterator::operator+(qsizetype j) const
Returns an iterator to the item at j positions forward from this iterator.
See also operator-() and operator+=().
QIterator<Container> &QIterator::operator++()
The prefix ++
operator (++it
) advances the iterator to the next item in the container and returns an iterator to the new current item.
Calling this function on QSequentialIterable::end() leads to undefined results.
See also operator--().
QIterator<Container> QIterator::operator++(int)
This is an overloaded function.
The postfix ++
operator (it++
) advances the iterator to the next item in the container and returns an iterator to the previously current item.
QIterator<Container> &QIterator::operator+=(qsizetype j)
Advances the iterator by j items.
See also operator-=() and operator+().
QIterator<Container> QIterator::operator-(qsizetype j) const
Returns an iterator to the item at j positions backward from this iterator.
If the container in the QVariant does not support bi-directional iteration, calling this function leads to undefined results.
See also operator+(), operator-=(), and QIterable::canReverseIterate().
qsizetype QIterator::operator-(const QIterator<Container> &j) const
This is an overloaded function.
Returns the distance between the two iterators.
See also operator+(), operator-=(), and QIterable::canReverseIterate().
QIterator<Container> &QIterator::operator--()
The prefix --
operator (--it
) makes the preceding item current and returns an iterator to the new current item.
Calling this function on QSequentialIterable::begin() leads to undefined results.
If the container in the QVariant does not support bi-directional iteration, calling this function leads to undefined results.
See also operator++() and QIterable::canReverseIterate().
QIterator<Container> QIterator::operator--(int)
This is an overloaded function.
The postfix --
operator (it--
) makes the preceding item current and returns an iterator to the previously current item.
If the container in the QVariant does not support bi-directional iteration, calling this function leads to undefined results.
See also QIterable::canReverseIterate().
QIterator<Container> &QIterator::operator-=(qsizetype j)
Makes the iterator go back by j items.
If the container in the QVariant does not support bi-directional iteration, calling this function leads to undefined results.
See also operator+=(), operator-(), and QIterable::canReverseIterate().
bool QIterator::operator==(const QIterator<Container> &other) const
Returns true
if other points to the same item as this iterator; otherwise returns false
.
See also operator!=().