QMutableHashIterator Class

template <typename Key, typename T> class QMutableHashIterator

QMutableHashIterator 类为QHashQMultiHash 提供了 Java 风格的非常数迭代器。更多

Header: #include <QMutableHashIterator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

公共函数

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

详细说明

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

QMutableHashIterator<Key, T> 允许您遍历QHash 并修改哈希值。如果不想修改哈希值(或有一个常量QHash ),请使用速度稍快的QHashIterator

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

QHash<int QWidget*>hash;...QMutableHashIterator<QString,QWidget*>i(hash);while(i.hasNext()) { i.next();    qDebug() << i.key() << ": " << i.value();
}

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

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

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

QMutableHashIterator<int QWidget*>i(hash);while(i.findNext(widget)) {    qDebug() << "Found widget " << widget << " under key "
            <<i.key(); }

如果要在遍历哈希值时删除项目,请使用remove() 。如果要修改项目的值,请使用setValue() 。

示例

QMutableHashIterator<QString, QString> i(hash);
while (i.hasNext()) {
    i.next();
    if (i.key() == i.value())
        i.remove();
}

该示例删除了所有键和值相同的(键、值)对。

在任何时候,给定的散列上只能有一个可变迭代器处于活动状态。此外,当迭代器处于活动状态时(而不是通过迭代器),不应直接对散列作任何更改,因为这可能会使迭代器失效并导致未定义的行为。

另请参见 QHashIteratorQHash::iterator

成员函数文档

QMutableHashIterator::QMutableHashIterator(QHash<Key, T> &hash)

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

另请参阅 operator=() 。

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

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

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

void QMutableHashIterator::toFront()

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

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

void QMutableHashIterator::toBack()

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

另请参阅 toFront().

bool QMutableHashIterator::hasNext() const

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

另请参见 next() 。

T &QMutableHashIterator::value()

这是一个重载函数。

返回使用其中一个遍历函数跳转的最后一个项目的值,该值是一个非连续引用。

const Key &QMutableHashIterator::key() const

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

另请参见 value()。

bool QMutableHashIterator::findNext(const T &value)

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

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

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

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

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

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

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

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

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

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

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

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

void QMutableHashIterator::remove()

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

另请参见 setValue()。

void QMutableHashIterator::setValue(const T &value)

value 替换使用某个遍历函数跳转的最后一个项目的值。

遍历函数是next() 和findNext()。

另请参见 key()、value() 和remove()。

const T &QMutableHashIterator::value() const

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

另请参阅 key() 和setValue()。

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