QMutableMultiMapIterator Class

QMultiMap<int,QWidget*>multimap;
//...
QMutableMultiMapIterator<int,QWidget*>i(multimap);
while(i.hasNext()) {
    i.next();
    qDebug() << i.key() << ": " << i.value();
}

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

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

QMutableMultiMapIterator<QString, QString> i(multimap);
while (i.hasNext()) {
    i.next();
    if (i.key() == i.value())
        i.remove();
}

成员函数文档

QMutableMultiMapIterator::QMutableMultiMapIterator(QMultiMap<Key, T> &map)

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

另请参阅 operator=()。

bool QMutableMultiMapIterator::findNext(const T &value)

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

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

另请参阅 findPrevious()。

bool QMutableMultiMapIterator::findPrevious(const T &value)

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

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

另请参阅 findNext()。

bool QMutableMultiMapIterator::hasNext() const

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

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

bool QMutableMultiMapIterator::hasPrevious() const

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

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

const Key &QMutableMultiMapIterator::key() const

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

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

另请参阅 value()。

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

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

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

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

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

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

返回对下一个项的引用，同时不移动迭代器。

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

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

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

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

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

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

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

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

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

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

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

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

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

void QMutableMultiMapIterator::remove()

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

另请参阅 setValue()。

void QMutableMultiMapIterator::setValue(const T &value)

使用value 将最后一个被跳过的项目值替换为该值，该值是通过某个遍历函数跳过的。

这些遍历函数包括：next()、previous()、findNext() 和findPrevious()。

另请参阅 key()、value() 和remove()。

void QMutableMultiMapIterator::toBack()

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

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

void QMutableMultiMapIterator::toFront()

将迭代器移至容器开头（第一个元素之前）。

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

const T &QMutableMultiMapIterator::value() const

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

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

另请参阅 key() 和setValue()。

T &QMutableMultiMapIterator::value()

返回对使用其中一个遍历函数跳过的最后一个项的值的非 const 引用。

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

使迭代器在map 上运行。将迭代器定位到映射的开头（第一个元素之前）。

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