QMutableLinkedListIterator Class

成员函数文档

QMutableLinkedListIterator::QMutableLinkedListIterator(QLinkedList<T> &list)

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

另请参阅 operator=()。

bool QMutableLinkedListIterator::findNext(const T &value)

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

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

另请参阅 findPrevious()。

bool QMutableLinkedListIterator::findPrevious(const T &value)

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

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

另请参阅 findNext()。

bool QMutableLinkedListIterator::hasNext() const

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

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

bool QMutableLinkedListIterator::hasPrevious() const

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

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

void QMutableLinkedListIterator::insert(const T &value)

在当前迭代器位置插入value 。调用完成后，迭代器将位于被插入项的正后方。

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

T &QMutableLinkedListIterator::next()

返回对下一个元素的引用，并将迭代器向前移动一个位置。

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

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

T &QMutableLinkedListIterator::peekNext() const

返回对下一个元素的引用，且不移动迭代器。

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

另请参阅 hasNext()、next()，以及peekPrevious()。

T &QMutableLinkedListIterator::peekPrevious() const

返回对前一个元素的引用，且不移动迭代器。

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

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

T &QMutableLinkedListIterator::previous()

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

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

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

void QMutableLinkedListIterator::remove()

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

示例：

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

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

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

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

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

示例：

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

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

void QMutableLinkedListIterator::toBack()

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

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

void QMutableLinkedListIterator::toFront()

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

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

const T &QMutableLinkedListIterator::value() const

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

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

另请参阅 setValue()。

T &QMutableLinkedListIterator::value()

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

QMutableLinkedListIterator<T> &QMutableLinkedListIterator::operator=(QLinkedList<T> &list)

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

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