QSetIterator Class
template <typename T> class QSetIteratorQSetIterator 类为QSet 提供了一个 Java 风格的 const 迭代器。更多内容...
| 头文件： | #include <QSetIterator> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake： | QT += core |
- 所有成员的列表，包括继承的成员
- QSetIterator 是Qt 中 Java 风格迭代器的一部分。
公共函数
| QSetIterator(const QSet<T> &set) | |
| bool | findNext(const T &value) |
| bool | hasNext() const |
| const T & | next() |
| const T & | peekNext() const |
| void | toBack() |
| void | toFront() |
| QSetIterator<T> & | operator=(const QSet<T> &set) |
详细说明
QSet 同时支持Java 风格迭代器和 STL 风格迭代器。STL 风格迭代器效率更高，应优先使用。模板参数T 指定了集合中存储的项的类型。
QSetIterator<T> 允许您遍历QSet<T>。如果您希望在遍历集合时对其进行修改，请改用QMutableSetIterator<T>。
构造函数接受一个 `QSet ` 作为参数。构造完成后，迭代器位于集合的最前端（第一个元素之前）。以下是如何依次遍历所有元素的方法：
QSet<QString> set;
//...
QSetIterator<QString> i(set);
while (i.hasNext())
QString f = i.next();next() 函数返回集合中的下一个元素，并使迭代器向前移动。与 STL 风格的迭代器不同，Java 风格的迭代器指向元素之间，而非直接指向某个元素。 第一次调用 `next()` 会将迭代器移至第一个和第二个元素之间的位置，并返回第一个元素；第二次调用 `next()` 会将迭代器移至第二个和第三个元素之间的位置，并返回第二个元素；依此类推。
如果要查找某个特定值的所有出现位置，请在循环中使用findNext()。
同一个集合上可以使用多个迭代器。如果在 QSetIterator 处于活动状态时对集合进行了修改，QSetIterator 将继续遍历原始集合，忽略被修改的副本。
另请参阅 QMutableSetIterator 和QSet::const_iterator 。
成员函数文档
QSetIterator::QSetIterator(const QSet<T> &set)
构建一个用于遍历set 的迭代器。该迭代器被设置为位于集合的开头（第一个元素之前）。
另请参阅 operator=()。
bool QSetIterator::findNext(const T &value)
从当前迭代器位置开始向前搜索value 。如果找到value ，则返回true ；否则返回false 。
调用后，若找到了 `value `，迭代器将定位在匹配项的紧后方；否则，迭代器将定位在容器的末尾。
bool QSetIterator::hasNext() const
如果迭代器前方至少有一个元素（即迭代器未位于容器的末尾），则返回true ；否则返回false 。
另请参阅 next()。
const T &QSetIterator::next()
返回下一个元素，并将迭代器向前移动一个位置。
若在位于容器末尾的迭代器上调用此函数，将导致结果未定义。
const T &QSetIterator::peekNext() const
返回下一个元素，同时不移动迭代器。
若在位于容器末尾的迭代器上调用此函数，将导致未定义的结果。
void QSetIterator::toBack()
将迭代器移至容器的末尾（最后一个元素之后）。
另请参阅 toFront()。
void QSetIterator::toFront()
将迭代器移至容器开头（第一个元素之前）。
QSetIterator<T> &QSetIterator::operator=(const QSet<T> &set)
使迭代器在set 上运行。迭代器被设置为位于集合的开头（第一个元素之前）。
© 2026 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.
