QFutureIterator Class

QFuture<QString> future;
//...
QFutureIterator<QString> i(future);
while (i.hasNext())
    QString s = i.next();

QFutureIterator<QString> i(future);
i.toBack();
while (i.hasPrevious())
    QString s = i.previous();

成员函数文档

QFutureIterator::QFutureIterator(const QFuture<T> &future)

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

另请参阅 operator=()。

bool QFutureIterator::findNext(const T &value)

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

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

另请参阅 findPrevious()。

bool QFutureIterator::findPrevious(const T &value)

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

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

另请参阅 findNext()。

bool QFutureIterator::hasNext() const

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

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

bool QFutureIterator::hasPrevious() const

如果迭代器前方至少有一个结果（例如，迭代器不在结果列表的最前端），则返回true ；否则返回false。

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

const T &QFutureIterator::next()

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

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

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

const T &QFutureIterator::peekNext() const

返回下一个结果，同时不移动迭代器。

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

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

const T &QFutureIterator::peekPrevious() const

返回上一个结果，同时不移动迭代器。

若在位于结果列表首部的迭代器上调用此函数，将导致未定义的结果。

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

const T &QFutureIterator::previous()

返回上一个结果，并将迭代器向后移动一个位置。

若在位于结果列表首部的迭代器上调用此函数，将导致未定义的行为。

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

void QFutureIterator::toBack()

将迭代器移动到结果列表的末尾（最后一个结果之后）。

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

void QFutureIterator::toFront()

将迭代器移至结果列表的开头（位于第一个结果之前）。

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

QFutureIterator<T> &QFutureIterator::operator=(const QFuture<T> &future)

使迭代器在future 上运行。迭代器被设置为位于结果列表的最前端（第一个结果之前）。

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