QHashIterator Class

template <typename Key, typename T> class QHashIterator

QHashIterator 类为QHashQMultiHash 提供了 Java 风格的常量迭代器。更多

头文件: #include <QHashIterator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

公共函数

QHashIterator(const QHash<Key, T> &hash)
bool findNext(const T &value)
bool hasNext() const
const Key &key() const
QHashIterator<Key, T>::Item next()
QHashIterator<Key, T>::Item peekNext() const
void toBack()
void toFront()
const T &value() const
QHashIterator<Key, T> &operator=(const QHash<Key, T> &hash)

详细说明

QHash 既有Java 风格的迭代器,也有STL 风格的迭代器。STL 样式的迭代器效率更高,应优先使用。

QHashIterator<Key, T> 允许遍历QHash (或QMultiHash )。如果想在遍历过程中修改哈希值,请使用QMutableHashIterator

QHashIterator 构造函数的参数是QHash 。构造完成后,迭代器将位于散列的最开头(第一个项目之前)。下面是按顺序遍历所有元素的方法:

QHash<intQWidget*>hash;...QHashIterator<intQWidget*>i(hash);while(i.hasNext()) { i.next();    qDebug() << i.key() << ": " << i.value();
}

next() 函数返回散列中的下一个项目,并向前推进迭代器。key() 和value() 函数返回上一个跳转项的键和值。

与 STL 风格的迭代器不同,Java 风格的迭代器指向项目之间,而不是直接指向项目。第一次调用next() 会将迭代器推进到第一个和第二个项目之间的位置,并返回第一个项目;第二次调用next() 会将迭代器推进到第二个和第三个项目之间的位置;以此类推。

如果要查找某一特定值的所有出现次数,请在一个循环中使用findNext()。例如

QHashIterator<intQWidget*>i(hash);while(i.findNext(widget)) {    qDebug() << "Found widget " << widget << " under key "
            <<i.key(); }

可以在同一个哈希值上使用多个迭代器。如果在 QHashIterator 处于活动状态时修改了散列,QHashIterator 将继续迭代原始散列,而忽略修改后的副本。

另请参阅 QMutableHashIteratorQHash::const_iterator

成员函数文档

QHashIterator::QHashIterator(const QHash<Key, T> &hash)

构造用于遍历hash 的迭代器。迭代器被设置为位于哈希值的前端(第一个项目之前)。

另请参阅 operator=() 。

QHashIterator<Key, T> &QHashIterator::operator=(const QHash<Key, T> &hash)

使迭代器在hash 上运行。迭代器被设置在哈希值的前端(第一个项目之前)。

另请参阅 toFront() 和toBack()。

void QHashIterator::toFront()

将迭代器移到容器的前面(第一个项目之前)。

另请参阅 toBack() 和next()。

void QHashIterator::toBack()

将迭代器移动到容器的后面(最后一个项目之后)。

另请参阅 toFront().

bool QHashIterator::hasNext() const

如果迭代器前面至少有一个项目,即迭代器在容器的后面,则返回true ;否则返回false

另请参见 next() 。

const Key &QHashIterator::key() const

返回使用某个遍历函数(next(),findNext() )跳转的最后一个项目的键值。

另请参见 value()。

bool QHashIterator::findNext(const T &value)

从当前迭代器位置向前搜索value 。如果找到值为value 的(键、值)对,则返回true ;否则返回false

调用后,如果找到value ,迭代器将被放置在匹配项之后;否则,迭代器将被放置在容器的后面。

QHashIterator<Key, T>::Item QHashIterator::next()

返回下一个项目,并将迭代器向前推进一个位置。

在返回值上调用key() 获取项的键,在返回值上调用value() 获取项的值。

对位于容器后部的迭代器调用此函数会导致未定义的结果。

另请参阅 hasNext() 和peekNext()。

QHashIterator<Key, T>::Item QHashIterator::peekNext() const

在不移动迭代器的情况下返回下一个项目。

在返回值上调用key() 获取项的键,在返回值上调用value() 获取项的值。

对位于容器后部的迭代器调用此函数会导致未定义的结果。

另请参阅 hasNext() 和next()。

const T &QHashIterator::value() const

返回使用某个遍历函数(next(),findNext() )跳转的最后一个项目的值。

另请参见 key()。

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