QListIterator Class
template <typename T> class QListIteratorQListIterator 类为QList 和QQueue 提供了 Java 风格的常量迭代器。更多
头文件: | #include <QListIterator> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
qmake: | QT += core |
公共函数
QListIterator(const QList<T> &list) | |
bool | findNext(const T &value) |
bool | findPrevious(const T &value) |
bool | hasNext() const |
bool | hasPrevious() const |
const T & | next() |
const T & | peekNext() const |
const T & | peekPrevious() const |
const T & | previous() |
void | toBack() |
void | toFront() |
QListIterator<T> & | operator=(const QList<T> &list) |
详细说明
QList 既有Java 风格的迭代器,也有STL 风格的迭代器。STL 风格的迭代器效率更高,应优先使用。
使用迭代器的另一种方法是使用索引位置。大多数QList 成员函数都将索引作为第一个参数,这样就可以在不使用迭代器的情况下访问、修改和删除项目。
QListIterator<T> 允许您遍历QList<T>、QQueue<T>或QStack<T>。如果想在遍历时修改列表,请使用QMutableListIterator<T>。
QListIterator 构造函数的参数是QList 。构造完成后,迭代器位于列表的最开始(第一个项目之前)。下面是按顺序遍历所有元素的方法:
QList<float> list; ... QListIterator<float> i(list); while (i.hasNext()) float f = i.next();
next() 函数返回列表中的下一项,并将迭代器向前推进。与 STL 风格的迭代器不同,Java 风格的迭代器指向项目之间,而不是直接指向项目。第一次调用next() 会将迭代器前进到第一项和第二项之间的位置,并返回第一项;第二次调用next() 会将迭代器前进到第二项和第三项之间的位置,并返回第二项;以此类推。
下面是以相反顺序遍历元素的方法:
QListIterator<float> i(list); i.toBack(); while (i.hasPrevious()) float f = i.previous();
如果要查找特定值的所有出现次数,请在循环中使用findNext() 或findPrevious() 。
可以在同一个列表中使用多个迭代器。如果在 QListIterator 处于活动状态时修改了列表,QListIterator 将继续迭代原始列表,而忽略修改后的副本。
另请参阅 QMutableListIterator 和QList::const_iterator 。
成员函数文档
QListIterator::QListIterator(const QList<T> &list)
构造一个遍历list 的迭代器。迭代器被设置为位于列表的前端(第一个项目之前)。
另请参阅 operator=() 。
QListIterator<T> &QListIterator::operator=(const QList<T> &list)
使迭代器在list 上运行。迭代器被设置在列表的前端(第一个项目之前)。
void QListIterator::toFront()
将迭代器移到容器的前面(第一个项目之前)。
void QListIterator::toBack()
将迭代器移到容器的后面(最后一个项目之后)。
bool QListIterator::hasNext() const
如果迭代器前面至少有一个项目,即迭代器不在容器的后面,则返回true
;否则返回false
。
另请参见 hasPrevious() 和next()。
bool QListIterator::hasPrevious() const
如果迭代器后面至少有一个项目,即迭代器不在容器的前面,则返回true
;否则返回false
。
bool QListIterator::findNext(const T &value)
从当前迭代器位置向前搜索value 。如果找到value ,则返回true
;否则返回false
。
调用后,如果找到value ,迭代器将被放置在匹配项之后;否则,迭代器将被放置在容器的后面。
另请参阅 findPrevious() 。
bool QListIterator::findPrevious(const T &value)
从当前迭代器位置向后搜索value 。如果找到value ,则返回true
;否则返回 false。
调用后,如果找到value ,迭代器将被放置在匹配项的前面;否则,迭代器将被放置在容器的前面。
另请参阅 findNext() 。
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()。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.