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.*> i(map); while (i.findNext(widget)) 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=() 。

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

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

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

void QMutableMapIterator::toFront()

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

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

void QMutableMapIterator::toBack()

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

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

bool QMutableMapIterator::hasNext() const

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

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

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::peekNext() const

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

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

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

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

bool QMutableMapIterator::hasPrevious() const

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

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

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

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

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

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

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

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

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

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

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

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

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 Key &QMutableMapIterator::key() const

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

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

另请参阅 value()。

bool QMutableMapIterator::findNext(const T &value)

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

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

另请参阅 findPrevious() 。

bool QMutableMapIterator::findPrevious(const T &value)

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

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

另请参阅 findNext() 。

void QMutableMapIterator::remove()

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

另请参见 setValue()。

void QMutableMapIterator::setValue(const T &value)

用value 替换使用某个遍历函数跳过的最后一个项目的值。

遍历函数包括next(),previous(),findNext() 和findPrevious() 。

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