En esta página

QMutableSetIterator Class

template <typename T> class QMutableSetIterator

La clase `QMutableSetIterator` proporciona un iterador no constante, al estilo de Java, para ` QSet`. Más información...

Encabezado: #include <QMutableSetIterator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Funciones públicas

QMutableSetIterator(QSet<T> &set)
bool findNext(const T &value)
bool hasNext() const
const T &next()
const T &peekNext() const
void remove()
void toBack()
void toFront()
const T &value() const
QMutableSetIterator<T> &operator=(QSet<T> &set)

Descripción detallada

QSet cuenta tanto con iteradores al estilo Java como con iteradores al estilo STL. Los iteradores al 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.

QMutableSetIterator<T> te permite recorrer un QSet<T> y eliminar elementos del conjunto a medida que avanzas. Si no deseas modificar el conjunto (o tienes un QSet de tipo const), utiliza en su lugar el QSetIterator<T>, que es ligeramente más rápido.

El constructor de `QMutableSetIterator` toma un ` QSet ` como argumento. Tras la construcción, el iterador se sitúa justo al principio del conjunto (antes del primer elemento). A continuación se muestra cómo recorrer todos los elementos de forma secuencial:

QSet<float> set;
//...
QMutableSetIterator<float> i(set);
while (i.hasNext())
    float f = i.next();

La función next() devuelve el siguiente elemento del conjunto y hace avanzar el iterador. A diferencia de los iteradores al estilo STL, los iteradores al 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.

Posiciones del iterador entre los elementos A, B, C y D

Si deseas eliminar elementos mientras iteras sobre el conjunto, utiliza remove().

Solo puede haber un iterador mutable activo en un conjunto dado en un momento dado. Además, no se deben realizar cambios directamente en el conjunto mientras el iterador esté activo (a diferencia de lo que ocurre al hacerlo a través del iterador), ya que esto podría invalidar el iterador y provocar un comportamiento indefinido.

Véase también QSetIterator y QSet::iterator.

Documentación de funciones miembro

QMutableSetIterator::QMutableSetIterator(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 QMutableSetIterator::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 QMutableSetIterator::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 &QMutableSetIterator::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éase también hasNext() y peekNext().

const T &QMutableSetIterator::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 QMutableSetIterator::remove()

Elimina el último elemento que se ha saltado utilizando una de las funciones de recorrido (next(), findNext()).

Ejemplo:

QMutableSetIterator<int> i(set);
while (i.hasNext()) {
    int val = i.next();
    if (val < -32768 || val > 32767)
        i.remove();
}

Véase también value().

void QMutableSetIterator::toBack()

Desplaza el iterador hasta el final del contenedor (después del último elemento).

Véase también toFront().

void QMutableSetIterator::toFront()

Desplaza el iterador al principio del contenedor (antes del primer elemento).

Véase también ` toBack()` y ` next()`.

const T &QMutableSetIterator::value() const

Devuelve el valor del último elemento que se ha omitido mediante ` next()` o ` findNext()`.

QMutableSetIterator<T> &QMutableSetIterator::operator=(QSet<T> &set)

Hace que el iterador opere sobre set. El iterador se sitúa al principio del conjunto (antes del primer elemento).

Véase también toFront() y toBack().

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