QMutableHashIterator Class

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

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

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

成员函数文档

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

构建一个用于遍历hash 的迭代器。该迭代器被设置为位于哈希表的开头（第一个元素之前）。

另请参阅 operator=()。

bool QMutableHashIterator::findNext(const T &value)

从当前迭代器位置开始向前搜索value 。如果找到了值为value 的(key, value)键值对，则返回true ；否则返回false 。

调用完成后，如果找到了value ，迭代器将定位在匹配项的紧后方；否则，迭代器将定位在容器的末尾。

bool QMutableHashIterator::hasNext() const

如果迭代器前方至少有一个元素（即迭代器未位于容器的末尾），则返回true ；否则返回false 。

另请参阅 next()。

const Key &QMutableHashIterator::key() const

返回使用其中一个遍历函数（next()、findNext()）跳过的最后一个项的键。

另请参阅 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()。

void QMutableHashIterator::toBack()

将迭代器移至容器末尾（最后一个元素之后）。

另请参阅 toFront()。

void QMutableHashIterator::toFront()

将迭代器移至容器开头（第一个元素之前）。

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

const T &QMutableHashIterator::value() const

返回使用其中一个遍历函数（next()、findNext()）跳过的最后一个项的值。

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

T &QMutableHashIterator::value()

返回对使用某个遍历函数跳过的最后一个元素的值的非常量引用。

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

使迭代器在hash 上运行。迭代器被设置为位于哈希表的开头（第一个元素之前）。

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