QListIterator Class

QList<float> list;
//...
QListIterator<float> i(list);
while (i.hasNext())
    float f = i.next();

QListIterator<float> i(list);
i.toBack();
while (i.hasPrevious())
    float f = i.previous();

成员函数文档

QListIterator::QListIterator(const QList<T> &list)

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

另请参阅 operator=()。

bool QListIterator::findNext(const T &value)

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

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

另请参阅 findPrevious()。

bool QListIterator::findPrevious(const T &value)

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

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

另请参阅 findNext()。

bool QListIterator::hasNext() const

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

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

bool QListIterator::hasPrevious() const

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

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

const T &QListIterator::next()

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

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

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

const T &QListIterator::peekNext() const

返回下一个元素，同时不移动迭代器。

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

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

const T &QListIterator::peekPrevious() const

返回前一个元素，同时不移动迭代器。

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

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

const T &QListIterator::previous()

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

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

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

void QListIterator::toBack()

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

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

void QListIterator::toFront()

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

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

QListIterator<T> &QListIterator::operator=(const QList<T> &list)

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

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