QHashIterator Class

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

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

成员函数文档

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

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

另请参阅 operator=()。

bool QHashIterator::findNext(const T &value)

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

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

bool QHashIterator::hasNext() const

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

另请参阅 next()。

const Key &QHashIterator::key() const

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

另请参阅 value()。

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

返回下一个项目，并将迭代器向前移动一个位置。

调用返回值的 `key()` 方法可获取该项的键，调用 `value()` 方法可获取其值。

在位于容器末尾的迭代器上调用此函数会导致未定义的结果。

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

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

返回下一个项目，同时不移动迭代器。

调用返回值的 `key()` 可获取该项的键，调用 `value()` 可获取其值。

在位于容器末尾的迭代器上调用此函数将导致未定义的结果。

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

void QHashIterator::toBack()

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

另请参阅 toFront()。

void QHashIterator::toFront()

将迭代器移动到容器的最前端（第一个元素之前）。

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

const T &QHashIterator::value() const

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

另请参阅 key()。

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

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

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