QLinkedList::iterator Class
class QLinkedList::iteratorLa clase ` QLinkedList::iterator ` proporciona un iterador no constante al estilo STL para ` QLinkedList`. Más información...
Funciones públicas
| iterator() | |
| bool | operator!=(const QLinkedList<T>::const_iterator &other) const |
| bool | operator!=(const QLinkedList<T>::iterator &other) const |
| T & | operator*() const |
| QLinkedList<T>::iterator | operator+(int j) const |
| QLinkedList<T>::iterator & | operator++() |
| QLinkedList<T>::iterator | operator++(int) |
| QLinkedList<T>::iterator & | operator+=(int j) |
| QLinkedList<T>::iterator | operator-(int j) const |
| QLinkedList<T>::iterator & | operator--() |
| QLinkedList<T>::iterator | operator--(int) |
| QLinkedList<T>::iterator & | operator-=(int j) |
| T * | operator->() const |
| bool | operator==(const QLinkedList<T>::const_iterator &other) const |
| bool | operator==(const QLinkedList<T>::iterator &other) const |
Descripción detallada
QLinkedList cuenta tanto con iteradores al estilo STL como con iteradores al estilo Java. Los iteradores al estilo STL son de menor nivel 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.
QLinkedList<T>::iterator te permite recorrer una QLinkedList<T> y modificar el elemento de la lista asociado al iterador. Si desea recorrer un `const QLinkedList`, utilice en su lugar ` QLinkedList::const_iterator `. Por lo general, es una buena práctica utilizar ` QLinkedList::const_iterator ` también en un `non-const QLinkedList `, a menos que necesite modificar el ` QLinkedList ` a través del iterador. Los iteradores `const` son ligeramente más rápidos y pueden mejorar la legibilidad del código.
El constructor predeterminado QLinkedList::iterator crea un iterador sin inicializar. Debes inicializarlo utilizando una función como QLinkedList::begin(), QLinkedList::end() o QLinkedList::insert() antes de poder comenzar a iterar. A continuación se muestra un bucle típico que imprime todos los elementos almacenados en una lista:
QLinkedList<QString> list;
list.append("January");
list.append("February");
...
list.append("December");
QLinkedList<QString>::iterator i;
for (i = list.begin(); i != list.end(); ++i)
cout << *i << Qt::endl;Los iteradores de estilo STL pueden utilizarse como argumentos de generic algorithms. Por ejemplo, así es como se busca un elemento en la lista:
QLinkedList<QString> list;
...
QLinkedList<QString>::iterator it = std::find(list.begin(),
list.end(), "Joel");
if (it != list.end())
cout << "Found Joel" << Qt::endl;Veamos algunos ejemplos de cosas que podemos hacer con un ` QLinkedList::iterator ` y que no podemos hacer con un ` QLinkedList::const_iterator`. He aquí un ejemplo que incrementa en 2 cada valor almacenado en una ` QLinkedList<int>`:
QLinkedList<int>::iterator i;
for (i = list.begin(); i != list.end(); ++i)
*i += 2;A continuación se muestra un ejemplo que elimina todos los elementos que comienzan con un carácter de guión bajo en un QLinkedList<QString>:
QLinkedList<QString> list;
...
QLinkedList<QString>::iterator i = list.begin();
while (i != list.end()) {
if ((*i).startsWith('_'))
i = list.erase(i);
else
++i;
}La llamada a QLinkedList::erase() elimina de la lista el elemento al que apunta el iterador y devuelve un iterador al siguiente elemento. Aquí tienes otra forma de eliminar un elemento mientras se itera:
QLinkedList<QString>::iterator i = list.begin();
while (i != list.end()) {
QLinkedList<QString>::iterator previous = i;
++i;
if ((*previous).startsWith('_'))
list.erase(previous);
}Puede resultar tentador escribir código como este:
// WRONG
while (i != list.end()) {
if ((*i).startsWith('_'))
list.erase(i);
++i;
}Sin embargo, esto podría provocar un fallo en ` ++i`, ya que ` i ` se convierte en un iterador colgante tras la llamada a ` erase()`.
Se pueden utilizar varios iteradores en la misma lista. Si añades elementos a la lista, los iteradores existentes seguirán siendo válidos. Si eliminas elementos de la lista, los iteradores que apunten a los elementos eliminados se convertirán en iteradores colgantes.
Advertencia: Los iteradores de 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 problema de los iteradores de uso compartido implícito.
Véase también « QLinkedList::const_iterator » y « QMutableLinkedListIterator ».
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 QLinkedList::begin() y QLinkedList::end().
bool iterator::operator!=(const QLinkedList<T>::const_iterator &other) const
bool iterator::operator!=(const QLinkedList<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==().
T &iterator::operator*() const
Devuelve una referencia modificable al elemento actual.
Puedes cambiar el valor de un elemento utilizando el operador *() en el lado izquierdo de una asignación, por ejemplo:
if (*it == "Hello")
*it = "Bonjour";Véase también operator->().
QLinkedList<T>::iterator iterator::operator+(int j) const
Devuelve un iterador al elemento situado a j posiciones por delante de este iterador. (Si j es negativo, el iterador se desplaza hacia atrás.)
Esta operación puede resultar lenta cuando los valores de ` j ` son grandes.
Véase también operator-().
QLinkedList<T>::iterator &iterator::operator++()
El operador prefijo ++ (++it) hace avanzar al iterador hasta el siguiente elemento de la lista y devuelve un iterador al nuevo elemento actual.
Llamar a esta función en QLinkedList::end() da lugar a resultados indefinidos.
Véase también operator--().
QLinkedList<T>::iterator iterator::operator++(int)
El operador postfijo ++ (it++) avanza el iterador hasta el siguiente elemento de la lista y devuelve un iterador al elemento que era el actual anteriormente.
Se trata de una función sobrecargada.
QLinkedList<T>::iterator &iterator::operator+=(int j)
Avanza el iterador j elementos. (Si j es negativo, el iterador retrocede.)
Véanse también operator-=() y operator+().
QLinkedList<T>::iterator iterator::operator-(int j) const
Devuelve un iterador que apunta al elemento situado a j posiciones hacia atrás desde este iterador. (Si j es negativo, el iterador avanza.)
Esta operación puede resultar lenta si los valores de ` j ` son muy grandes.
Véase también operator+().
QLinkedList<T>::iterator &iterator::operator--()
El operador prefijo (--it) establece el elemento anterior como el actual y devuelve un iterador al nuevo elemento actual.
La llamada a esta función en QLinkedList::begin() da lugar a resultados indefinidos.
Véase también operator++().
QLinkedList<T>::iterator iterator::operator--(int)
El operador postfijo – (it--) convierte el elemento anterior en el elemento actual y devuelve un iterador al elemento que era el actual anteriormente.
Se trata de una función sobrecargada.
QLinkedList<T>::iterator &iterator::operator-=(int j)
Hace que el iterador retroceda j elementos. (Si j es negativo, el iterador avanza.)
Véanse también operator+=() y operator-().
T *iterator::operator->() const
Devuelve un puntero al elemento actual.
Véase también operator*().
bool iterator::operator==(const QLinkedList<T>::const_iterator &other) const
bool iterator::operator==(const QLinkedList<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.