QSetIterator Class
template <typename T> class QSetIteratorLa clase `QSetIterator` proporciona un iterador `const` al estilo de Java para ` QSet`. Más información...
| Encabezado: | #include <QSetIterator> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los heredados
- QSetIterator forma parte de los iteradores al estilo Java en Qt.
Funciones públicas
| 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) |
Descripción detallada
QSet cuenta tanto con iteradores de estilo Java como con iteradores de estilo STL. Los iteradores de estilo STL son más eficientes y son los recomendados. El parámetro de plantilla T especifica el tipo de los elementos almacenados en el conjunto.
QSetIterator<T> permite iterar sobre un QSet<T>. Si deseas modificar el conjunto mientras iteras sobre él, utiliza en su lugar QMutableSetIterator<T>.
El constructor toma un ` QSet ` como argumento. Tras la construcción, el iterador se sitúa al principio del conjunto (antes del primer elemento). A continuación se muestra cómo recorrer todos los elementos de forma secuencial:
QSet<QString> set;
//...
QSetIterator<QString> i(set);
while (i.hasNext())
QString f = i.next();La función next() devuelve el siguiente elemento del conjunto y hace avanzar al iterador. A diferencia de los iteradores de estilo STL, los de estilo Java apuntan entre elementos en lugar de directamente a ellos. La primera llamada a next() hace avanzar el iterador hasta la posición entre el primer y el segundo elemento, y devuelve el primer elemento; la segunda llamada a next() hace avanzar el iterador hasta la posición entre el segundo y el tercer elemento, devolviendo el segundo elemento; y así sucesivamente.
Si deseas encontrar todas las apariciones de un valor concreto, utiliza ` findNext()` en un bucle.
Se pueden utilizar varios iteradores en el mismo conjunto. Si el conjunto se modifica mientras un QSetIterator está activo, el QSetIterator seguirá iterando sobre el conjunto original, ignorando la copia modificada.
Véase también QMutableSetIterator y QSet::const_iterator.
Documentación de las funciones miembro
QSetIterator::QSetIterator(const QSet<T> &set)
Crea un iterador para recorrer set. El iterador se sitúa al principio del conjunto (antes del primer elemento).
Véase también operator=().
bool QSetIterator::findNext(const T &value)
Busca « value » a partir de la posición actual del iterador y hacia adelante. Devuelve « true » si se encuentra « value »; en caso contrario, devuelve « false ».
Tras la llamada, si se ha encontrado value, el iterador se sitúa justo después del elemento coincidente; en caso contrario, el iterador se sitúa al final del contenedor.
bool QSetIterator::hasNext() const
Devuelve « true » si hay al menos un elemento por delante del iterador, es decir, si el iterador no se encuentra al final del contenedor; en caso contrario, devuelve « false ».
Véase también next().
const T &QSetIterator::next()
Devuelve el siguiente elemento y hace avanzar el iterador una posición.
La llamada a esta función en un iterador situado al final del contenedor da lugar a resultados indefinidos.
Véanse también hasNext() y peekNext().
const T &QSetIterator::peekNext() const
Devuelve el siguiente elemento sin desplazar el iterador.
Si se llama a esta función en un iterador situado al final del contenedor, se obtienen resultados indefinidos.
Véase también hasNext() y next().
void QSetIterator::toBack()
Desplaza el iterador hasta el final del contenedor (después del último elemento).
Véase también ` toFront()`.
void QSetIterator::toFront()
Desplaza el iterador al principio del contenedor (antes del primer elemento).
Véase también toBack() y next().
QSetIterator<T> &QSetIterator::operator=(const QSet<T> &set)
Hace que el iterador opere sobre set. El iterador se sitúa al principio del conjunto (antes del primer elemento).
© 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.