QMultiMapIterator Class

QMultiMap<int、 QWidget*>multimap;...QMultiMapIterator<int、 QWidget*>i(multimap);while(i.hasNext()) { i.next()；    qDebug() << i.key() << ": " << i.value();
}

QMultiMapIterator<int、 QWidget*>i(multimap); i.toBack();while(i.hasPrevious()) { i.previous()；    qDebug() << i.key() << ": " << i.value();
}

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

成员函数文档

QMultiMapIterator::QMultiMapIterator(const QMultiMap<Key, T> &map)

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

另请参阅 operator=() 。

QMultiMapIterator<Key, T> &QMultiMapIterator::operator=(const QMultiMap<Key, T> &map)

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

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

void QMultiMapIterator::toFront()

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

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

void QMultiMapIterator::toBack()

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

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

bool QMultiMapIterator::hasNext() const

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

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

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

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

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

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

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

bool QMultiMapIterator::hasPrevious() const

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

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

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

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

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

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

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

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

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

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

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

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

const T &QMultiMapIterator::value() const

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

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

另请参阅 key()。

const Key &QMultiMapIterator::key() const

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

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

另请参阅 value()。

bool QMultiMapIterator::findNext(const T &value)

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

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

另请参阅 findPrevious() 。

bool QMultiMapIterator::findPrevious(const T &value)

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

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

另请参阅 findNext() 。