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=()。

bool QMultiMapIterator::findNext(const T &value)

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

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

另请参阅 findPrevious()。

bool QMultiMapIterator::findPrevious(const T &value)

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

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

另请参阅 findNext()。

bool QMultiMapIterator::hasNext() const

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

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

bool QMultiMapIterator::hasPrevious() const

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

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

const Key &QMultiMapIterator::key() const

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

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

另请参见 value()。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

void QMultiMapIterator::toBack()

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

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

void QMultiMapIterator::toFront()

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

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

const T &QMultiMapIterator::value() const

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

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

另请参阅 key()。

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

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

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