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.*> i(map); while (i.findNext(widget)) QWidget*>i(map);while(i.findNext(widget)) {    qDebug() << "Found widget " << widget << " under key "
            <<i.key(); }

成员函数文档

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

构造一个遍历map 的迭代器。迭代器被设置为位于地图的前端（第一个条目之前）。

另请参阅 operator=() 。

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

使迭代器在map 上运行。迭代器被设置在地图的前端（第一个项目之前）。

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

void QMapIterator::toFront()

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

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

void QMapIterator::toBack()

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

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

bool QMapIterator::hasNext() const

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

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

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

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

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

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

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

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

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

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

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

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

bool QMapIterator::hasPrevious() const

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

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

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

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

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

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

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

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

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

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

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

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

const T &QMapIterator::value() const

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

在调用next() 或findNext() 后，value() 等同于peekPrevious().value().在调用previous() 或findPrevious() 后，value() 等同于peekNext().value().

另请参阅 key()。

const Key &QMapIterator::key() const

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

在调用next() 或findNext() 后，key() 等同于peekPrevious().key().在调用previous() 或findPrevious() 后，key() 等同于peekNext().key().

另请参阅 value()。

bool QMapIterator::findNext(const T &value)

从当前迭代器位置向前搜索value 。如果找到值为value 的（键、值）对，则返回true ；否则返回false 。

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

另请参阅 findPrevious() 。

bool QMapIterator::findPrevious(const T &value)

从当前迭代器位置向后搜索value 。如果找到值为value 的（键、值）对，则返回true ；否则返回false 。

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

另请参阅 findNext() 。