QSetIterator Class

template <typename T> class QSetIterator

QSetIterator 类为QSet 提供了 Java 风格的常量迭代器。更多

头文件：	`#include <QSetIterator>`
CMake：	`find_package(Qt6 REQUIRED COMPONENTS Core)` `target_link_libraries(mytarget PRIVATE Qt6::Core)`
qmake：	`QT += core`

所有成员（包括继承成员）的列表

公共函数

	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 样式的迭代器效率更高，应优先使用。

QSetIterator<T> 允许你遍历QSet<T>。如果想在遍历时修改集合，请使用QMutableSetIterator<T>。

构造函数的参数是QSet 。构造完成后，迭代器位于集合的最开始（第一个项目之前）。下面是按顺序遍历所有元素的方法：

QSet<QString> set;
...
QSetIterator<QString> i(set);
while (i.hasNext())
    float f = i.next();

next() 函数返回集合中的下一项，并向前推进迭代器。与 STL 风格的迭代器不同，Java 风格的迭代器指向项之间，而不是直接指向项。第一次调用next() 会将迭代器前进到第一项和第二项之间的位置，并返回第一项；第二次调用next() 会将迭代器前进到第二项和第三项之间的位置，并返回第二项；以此类推。

如果要查找特定值的所有出现次数，请在一个循环中使用findNext()。

可以在同一个集合上使用多个迭代器。如果在 QSetIterator 处于活动状态时集合被修改，QSetIterator 将继续迭代原始集合，而忽略修改后的副本。

另请参阅 QMutableSetIterator 和QSet::const_iterator 。

成员函数文档

QSetIterator::QSetIterator(const QSet<T> &set)

构造一个遍历set 的迭代器。迭代器被设置为位于集合的前端（第一个项目之前）。

另请参阅 operator=() 。

QSetIterator<T> &QSetIterator::operator=(const QSet<T> &set)

使迭代器在set 上运行。迭代器被设置在集合的前端（第一个项目之前）。

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

void QSetIterator::toFront()

将迭代器移到容器的前面（第一个项目之前）。

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

bool QSetIterator::findNext(const T &value)

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

调用后，如果找到value ，迭代器将被放置在匹配项的后面；否则，迭代器将被放置在容器的后面。

bool QSetIterator::hasNext() const

如果迭代器前面至少有一个项目，即迭代器不在容器的后面，则返回true ；否则返回false 。

另请参见 next() 。

const T &QSetIterator::next()

返回下一个项目，并将迭代器向前推进一个位置。

对位于容器后部的迭代器调用此函数会导致未定义的结果。

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

const T &QSetIterator::peekNext() const

在不移动迭代器的情况下返回下一个项目。

对位于容器后部的迭代器调用此函数会导致未定义的结果。

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

void QSetIterator::toBack()

将迭代器移动到容器的后面（最后一个项目之后）。

另请参阅 toFront().

© 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.