QMapIterator Class

QMap<int,QWidget*>map;
//...
QMapIterator<int,QWidget*>i(map);
while(i.hasNext()) {
    i.next();
    qDebug() << i.key() << ": " << i.value();
}

QMapIterator<int,QWidget*>i(map);
i.toBack();
while(i.hasPrevious()) {
    i.previous();
    qDebug() << i.key() << ": " << i.value();
}

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

成员函数文档

QMapIterator::QMapIterator(const QMap<Key, T> &map)

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

另请参阅 operator=()。

bool QMapIterator::findNext(const T &value)

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

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

另请参阅 findPrevious()。

bool QMapIterator::findPrevious(const T &value)

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

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

另请参阅 findNext()。

bool QMapIterator::hasNext() const

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

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

bool QMapIterator::hasPrevious() const

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

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

const Key &QMapIterator::key() const

返回使用以下遍历函数之一（next()、previous()、findNext()、findPrevious()）跳过的最后一个项的键。

在调用next() 或findNext() 之后，key() 与peekPrevious() 效果等同。key()。在调用previous() 或findPrevious() 之后，key() 与peekNext() 效果等同。key()。

另请参阅 value()。

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

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

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

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

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

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

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

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

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

另请参见 hasNext()、next() 和peekPrevious()。

QMapIterator<Key, T>::Item QMapIterator::peekPrevious() const

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

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

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

另请参阅 hasPrevious()、previous() 和peekNext()。

QMapIterator<Key, T>::Item QMapIterator::previous()

返回上一个项，并将迭代器向后移动一个位置。

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

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

另请参阅 hasPrevious()、peekPrevious() 和next()。

void QMapIterator::toBack()

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

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

void QMapIterator::toFront()

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

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

const T &QMapIterator::value() const

返回使用以下遍历函数之一（next()、previous()、findNext()、findPrevious()）跳过的最后一个项的值。

在调用next() 或findNext() 之后，value() 与peekPrevious() 效果相同。value()。在调用previous() 或findPrevious() 之后，value() 与peekNext() 效果相同。value()。

另请参阅 key()。

QMapIterator<Key, T> &QMapIterator::operator=(const QMap<Key, T> &map)

使迭代器在map 上运行。迭代器被设置为位于映射的开头（第一个元素之前）。

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