QKeyValueIterator Class▲
-
Header: QKeyValueIterator
-
Since: Qt 5.10
-
CMake:
find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
-
qmake: QT += core
Detailed Description▲
The QKeyValueIterator class provides an STL-style iterator for returning key/value pairs from associative containers like QHash and QMap. It supports the same API as the STL associative containers, i.e. getting a key/value pair when iterating through the container.
This will allow for better interoperability between QMap, QHash and friends and STL-style algorithms.
Iterators on implicitly shared containers do not work exactly like STL-iterators. You should avoid copying a container while iterators are active on that container. For more information, read Implicit sharing iterator problem.
Member Function Documentation▲
QKeyValueIterator::QKeyValueIterator()▲
Constructs a default QKeyValueIterator.
[explicit constexpr] QKeyValueIterator::QKeyValueIterator(Iterator o)▲
Constructs a QKeyValueIterator on top of o.
Iterator QKeyValueIterator::base() const▲
Returns the underlying iterator this QKeyValueIterator is based on.
std::pair<Key, T> QKeyValueIterator::operator*() const▲
Returns the current entry as a pair.
QKeyValueIterator<Key, T, Iterator> &QKeyValueIterator::operator++()▲
The prefix ++ operator (++i) advances the iterator to the next item in the container and returns the iterator.
Advancing the iterator past its container's end() constitutes undefined behavior.
See Also▲
See also operator--()
QKeyValueIterator<Key, T, Iterator> QKeyValueIterator::operator++(int)▲
This is an overloaded function.
The postfix ++ operator (i++) advances the iterator to the next item in the container and returns the iterator's prior value.
Advancing the iterator past its container's end() constitutes undefined behavior.
QKeyValueIterator<Key, T, Iterator> &QKeyValueIterator::operator--()▲
The prefix – operator (--i) backs the iterator up to the previous item in the container and returns the iterator.
Backing up an iterator to before its container's begin() constitutes undefined behavior.
See Also▲
See also operator++()
QKeyValueIterator<Key, T, Iterator> QKeyValueIterator::operator--(int)▲
This is an overloaded function.
The postfix – operator (i--) backs the iterator up to the previous item in the container and returns the iterator's prior value.
Backing up an iterator to before its container's begin() constitutes undefined behavior.
[since 5.15] QKeyValueIterator::pointer QKeyValueIterator::operator->() const▲
Related Non-Members▲
bool operator!=(QKeyValueIterator<Key, T, Iterator> lhs, QKeyValueIterator<Key, T, Iterator> rhs)▲
Returns true if rhs points to a different item than lhs otherwise returns false.
See Also▲
See also operator==()
bool operator==(QKeyValueIterator<Key, T, Iterator> lhs, QKeyValueIterator<Key, T, Iterator> rhs)▲
Returns true if rhs points to the same item as lhs otherwise returns false.
See Also▲
See also operator!=()