En esta página

QSet::iterator Class

class QSet::iterator

La clase ` QSet::iterator ` proporciona un iterador no constante, al estilo de la STL, para ` QSet`. Más información...

Tipos públicos

Funciones públicas

iterator()
iterator(const QSet<T>::iterator &other)
bool operator!=(const QSet<T>::iterator &other) const
bool operator!=(const QSet<T>::const_iterator &other) const
const T &operator*() const
QSet<T>::iterator &operator++()
QSet<T>::iterator operator++(int)
const T *operator->() const
QSet<T>::iterator &operator=(const QSet<T>::iterator &other)
bool operator==(const QSet<T>::iterator &other) const
bool operator==(const QSet<T>::const_iterator &other) const

Descripción detallada

QSet cuenta tanto con iteradores al estilo STL como con iteradores al estilo Java. Los iteradores al estilo STL son de un nivel más bajo y más engorrosos de usar; por otro lado, son ligeramente más rápidos y, para los desarrolladores que ya conocen STL, tienen la ventaja de resultarles familiares.

QSet<T>::iterator te permite recorrer una QSet y eliminar elementos (utilizando QSet::erase()) mientras realizas el recorrido. (QSet no te permite modificar un valor a través de un iterador, ya que eso podría requerir mover el valor en la tabla hash interna utilizada por QSet.) Si deseas iterar sobre un ` QSet` constante, debes utilizar ` QSet::const_iterator`. Por lo general, es una buena práctica utilizar ` QSet::const_iterator ` también en un ` QSet ` no constante, a menos que necesites modificar el ` QSet ` a través del iterador. Los iteradores constantes son ligeramente más rápidos y pueden mejorar la legibilidad del código.

El constructor predeterminado QSet::iterator crea un iterador no inicializado. Debes inicializarlo utilizando una función como QSet::begin(), QSet::end() o QSet::insert() antes de poder empezar a iterar. A continuación se muestra un bucle típico que muestra todos los elementos almacenados en un conjunto:

QSet<QString> set = {"enero", "febrero", /*...*/ "diciembre"};

// i es un QSet<QString>::iterator
for (auto i = set.begin(), end = set.end(); i != end;++i)
    qDebug() << *i;

A continuación se muestra un bucle que elimina determinados elementos (todos los que empiezan por «J») de un conjunto mientras se itera:

QSet<QString> set = {"January", "February", /*...*/ "December"};

auto i = set.begin();
while (i != set.end()) {
    if ((*i).startsWith('J')) {
        i = set.erase(i);
    } else {
        ++i;
    }
}

Los iteradores de estilo STL se pueden utilizar como argumentos de generic algorithms. Por ejemplo, así es como se busca un elemento en el conjunto utilizando el algoritmo qFind():

QSet<QString> set;
//...
const auto predicate = [](const QString &s) { return s.compare("Jeanette", Qt::CaseInsensitive) == 0; };
QSet<QString>::iterator it = std::find_if(set.begin(), set.end(), predicate);
if (it != set.end())
    cout << "Found Jeanette" << endl;

Se pueden utilizar varios iteradores en el mismo conjunto.

Advertencia: los iteradores en contenedores compartidos implícitamente no funcionan exactamente igual que los iteradores de la STL. Debes evitar copiar un contenedor mientras haya iteradores activos en él. Para obtener más información, consulta el artículo «Problema con los iteradores de compartición implícita».

Véase también QSet::const_iterator y QMutableSetIterator.

Documentación sobre tipos de miembros

iterator::iterator_category

Sinónimos de «std::bidirectional_iterator_tag» que indican que estos iteradores son bidireccionales.

Documentación de las funciones miembro

iterator::iterator()

Crea un iterador no inicializado.

No se deben invocar funciones como operator*() y operator++() en un iterador no inicializado. Utiliza operator=() para asignarle un valor antes de utilizarlo.

Véase también QSet::begin() y QSet::end().

iterator::iterator(const QSet<T>::iterator &other)

Crea una copia de other.

bool iterator::operator!=(const QSet<T>::iterator &other) const

Devuelve ` true ` si ` other ` apunta a un elemento distinto de este iterador; en caso contrario, devuelve ` false`.

Véase también operator==().

bool iterator::operator!=(const QSet<T>::const_iterator &other) const

bool iterator::operator==(const QSet<T>::const_iterator &other) const

const T &iterator::operator*() const

Devuelve una referencia al elemento actual.

Véase también ` operator->()`.

QSet<T>::iterator &iterator::operator++()

El operador prefijo ++ (++it) avanza el iterador hasta el siguiente elemento del conjunto y devuelve un iterador al nuevo elemento actual.

La llamada a esta función en QSet<T>::constEnd() da lugar a resultados indefinidos.

QSet<T>::iterator iterator::operator++(int)

El operador postfijo ++ (it++) avanza el iterador hasta el siguiente elemento del conjunto y devuelve un iterador que apunta al elemento que era el actual anteriormente.

const T *iterator::operator->() const

Devuelve un puntero al elemento actual.

Véase también operator*().

QSet<T>::iterator &iterator::operator=(const QSet<T>::iterator &other)

Asigna « other » a este iterador.

bool iterator::operator==(const QSet<T>::iterator &other) const

Devuelve ` true ` si ` other ` apunta al mismo elemento que este iterador; en caso contrario, devuelve ` false`.

Véase también operator!=().

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