QMutableListIterator Class

成员函数文档

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

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

另请参阅 operator=()。

bool QMutableListIterator::findNext(const T &value)

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

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

另请参阅 findPrevious()。

bool QMutableListIterator::findPrevious(const T &value)

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

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

另请参阅 findNext()。

bool QMutableListIterator::hasNext() const

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

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

bool QMutableListIterator::hasPrevious() const

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

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

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

void QMutableListIterator::toBack()

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

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

void QMutableListIterator::toFront()

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

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

const T &QMutableListIterator::value() const

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

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

另请参阅 setValue()。

T &QMutableListIterator::value()

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

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

使迭代器在list 上运行。迭代器被设置为位于列表开头（第一个元素之前）。

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