La palabra clave «foreach» de Qt
La palabra clave «foreach»
Nota: La palabra clave «foreach» se introdujo antes de que existieran los bucles basados en rangos de C++11. En el código nuevo se deben preferir los bucles basados en rangos de C++11.
La palabra clave « foreach » es una adición específica de Qt al lenguaje C++ y se implementa mediante el preprocesador.
Su sintaxis es: foreach (variable, contenedor) instrucción. Por ejemplo, así es como se utiliza foreach para recorrer un QList<QString>:
El código de « foreach » es considerablemente más corto que el código equivalente que utiliza iteradores:
QList<QString> valores;
//...
QListIterator<QString> i(valores);
while (i.hasNext()) {
QString s = i.next();
qDebug() << s;
}A menos que el tipo de datos contenga una coma (por ejemplo, std::pair<int, int>), la variable utilizada para la iteración puede definirse dentro de la instrucción foreach:
Y, al igual que con cualquier otra estructura de bucle en C++, puedes utilizar llaves para delimitar el cuerpo de un bucle « foreach », y puedes utilizar « break » para salir del bucle:
QList<QString> valores;
//...
foreach (const QString&str, valores) {
if (str.isEmpty())
break;
qDebug() << str;
}Con QMap y QHash, foreach accede automáticamente al componente «valor» de los pares (clave, valor), por lo que no debes llamar a values() en el contenedor (generaría una copia innecesaria; véase más abajo). Si quieres iterar tanto sobre las claves como sobre los valores, puedes utilizar iteradores (que son más rápidos), o bien puedes obtener las claves y utilizarlas para obtener también los valores:
QMap<QString, int> map;
//...
foreach (const QString&str, map.keys())
qDebug() << str << ':' << map.value(str);En el caso de una función multivalorada:
QMultiMap<QString, int> mapa;
//...
foreach (const QString&str, map.uniqueKeys()) {
foreach (int i, map.values(str))
qDebug() << str << ':' << i;
}Qt realiza automáticamente una copia del contenedor cuando entra en un bucle « foreach ». Si modificas el contenedor mientras estás iterando, eso no afectará al bucle. (Si no modificas el contenedor, la copia se realiza de todos modos, pero gracias al uso compartido implícito, copiar un contenedor es muy rápido.)
Dado que «foreach» crea una copia del contenedor, el uso de una referencia no «const» para la variable no te permite modificar el contenedor original. Solo afecta a la copia, lo que probablemente no es lo que quieres.
Una alternativa al bucle « foreach » de Qt es el bucle basado en rangos « for », que forma parte de C++11 y versiones posteriores. Sin embargo, ten en cuenta que el bucle basado en rangos « for » podría obligar a un contenedor de Qt a desvincularse, mientras que « foreach » no lo haría. Pero el uso de « foreach » siempre copia el contenedor, lo que normalmente no es económico para los contenedores STL. En caso de duda, es preferible utilizar foreach para los contenedores de Qt y for para los de la STL.
Puedes desactivar la disponibilidad del bucle « foreach » de Qt XML definiendo la macro « QT_NO_FOREACH ».
© 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.