QMutableListIterator Class

成员函数文档

QMutableListIterator::QMutableListIterator(QList<T> &list)

构造一个遍历list 的迭代器。迭代器被设置为位于列表的前端（第一个项目之前）。

另请参阅 operator=() 。

QMutableListIterator<T> &QMutableListIterator::operator=(QList<T> &list)

使迭代器在list 上运行。迭代器被设置在列表的前端（第一个项目之前）。

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

void QMutableListIterator::toFront()

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

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

void QMutableListIterator::toBack()

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

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

bool QMutableListIterator::hasNext() const

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

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

bool QMutableListIterator::hasPrevious() const

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

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

bool QMutableListIterator::findNext(const T &value)

从当前迭代器位置向前搜索value 。如果找到value ，则返回true ；否则返回false 。

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

另请参阅 findPrevious() 。

bool QMutableListIterator::findPrevious(const T &value)

从当前迭代器位置向后搜索value 。如果找到value ，则返回true ；否则返回 false。

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

另请参阅 findNext() 。

void QMutableListIterator::insert(const T &value)

在当前迭代器位置插入value 。调用后，迭代器将位于插入项之后。

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

T &QMutableListIterator::next()

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

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

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

T &QMutableListIterator::peekNext() const

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

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

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

T &QMutableListIterator::peekPrevious() const

不移动迭代器，返回上一个项目的引用。

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

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

T &QMutableListIterator::previous()

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

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

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

void QMutableListIterator::remove()

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

示例：

QMutableListIterator<int> i(list);
while (i.hasNext()) {
    int val = i.next();
    if (val < -32768 || val > 32767)
        i.remove();
}

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

void QMutableListIterator::setValue(const T &value) const

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

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

示例：

QMutableListIterator<double> i(list);
while (i.hasNext()) {
    double val = i.next();
    i.setValue(std::sqrt(val));
}

另请参阅 value(),remove() 和insert()。

const T &QMutableListIterator::value() const

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

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

另请参阅 setValue()。

T &QMutableListIterator::value()

这是一个重载函数。

返回使用其中一个遍历函数跳转的最后一个项目的值，该值是一个非连续引用。