Número de sentencias de bucle

Actualizado el 15 de noviembre de 2026

Sigla LOOP
Aspecto «Complejidad»
Se mide en método
Tipo de valor recuento (entero, mínimo 0)
Dirección informativa: ni alto ni bajo es mejor
Stau Metro NumLoops

En pocas palabras

Cuenta los bucles de un método, estén uno dentro de otro o uno detrás de otro. Un método con varios bucles recorre datos varias veces, y cada recorrido es un sitio donde entender el flujo y probar los casos límite (vacío, uno, muchos).

Qué mide

Cuánta iteración explícita hay en el método. No dice cuánto cuesta ejecutarlo: un bucle puede recorrer tres elementos o tres millones, y dos bucles uno dentro de otro multiplican el trabajo, pero para esa diferencia está la «profundidad de anidamiento de bucles».

Cómo se calcula

Se suma 1 por cada for, for mejorado, while y do … while.

Ejemplo

void process(List<List<String>> table, List<String> extra) {
    for (List<String> row : table) {          // +1
        for (String cell : row) {             // +1
            use(cell);
        }
    }
    int i = 0;
    while (i < 3) { i++; }                    // +1
    do { i--; } while (i > 0);                // +1
    extra.forEach(s -> { for (char c : s.toCharArray()) { use(c); } }); // +1: el bucle de la lambda
}

Total: 5. La llamada forEach no es un bucle del lenguaje y no suma; el bucle de dentro de la lambda, sí.

Cómo interpretarla

No tiene umbrales. Un valor alto indica un método que recorre varias colecciones o que mezcla pasos de procesamiento; suele ser candidato a dividirse en métodos pequeños, uno por recorrido. Un valor 0 es normal en métodos de acceso o de coordinación. Compáralo con la profundidad de anidamiento de bucles: dos bucles seguidos (LOOP 2, profundidad 1) se leen con mucha más facilidad que dos anidados (LOOP 2, profundidad 2).

Relación con otras métricas

En las herramientas

Stau Metro (NumLoops, a nivel de método). Cuenta for, for mejorado, while y do … while, a cualquier nivel de anidamiento. Los bucles dentro de lambdas y de clases anónimas o locales declaradas en el método se suman a él. Las llamadas que iteran por dentro (forEach, streams) no cuentan. No se calcula para los métodos abstractos.

CK (herramienta de Aniche). Su loopQty cuenta «el número de bucles (es decir, for, while, do while, for mejorado)», las mismas cuatro construcciones.

Referencias