QMutableMapIterator Class

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

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

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

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

成员函数文档

QMutableMapIterator::QMutableMapIterator(QMap<Key, T> &map)

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

另请参阅 operator=()。

bool QMutableMapIterator::findNext(const T &value)

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

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

另请参阅 findPrevious()。

bool QMutableMapIterator::findPrevious(const T &value)

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

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

另请参阅 findNext()。

bool QMutableMapIterator::hasNext() const

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

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

bool QMutableMapIterator::hasPrevious() const

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

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

const Key &QMutableMapIterator::key() const

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

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

另请参阅 value()。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

void QMutableMapIterator::remove()

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

另请参阅 setValue()。

void QMutableMapIterator::setValue(const T &value)

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

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

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

void QMutableMapIterator::toBack()

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

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

void QMutableMapIterator::toFront()

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

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

const T &QMutableMapIterator::value() const

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

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

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

T &QMutableMapIterator::value()

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

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

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

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