Número de sentencias de ramificación
| Sigla | BRANCH |
| 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 | NumBranchStatements |
En pocas palabras
Cuenta los saltos que un método hace dentro de sus bucles: cada continue y cada break que corta un bucle. Un bucle
que termina cuando se agota su condición no suma nada; uno que se interrumpe por la mitad, sí.
Qué mide
Cuántas veces el flujo de un método abandona el camino normal de sus bucles (terminar la iteración y evaluar la condición). Los saltos hacen más difícil seguir el flujo: para saber qué ocurre tras una línea hay que buscar también qué otras líneas pueden saltarse. Son, además, una de las causas de los grafos de control no estructurados que mide la «complejidad ciclomática esencial».
Cómo se calcula
Se suma 1 por cada continue y 1 por cada break, salvo el break sin etiqueta que sale de una sentencia
switch, que es la forma normal de cerrar un case y no se cuenta.
Ejemplo
static int scan(int[][] rows) {
int found = 0;
outer:
for (int[] row : rows) {
for (int v : row) {
if (v == 0) continue; // +1 continue
if (v < 0) { found = v; break outer; } // +1 break con etiqueta
switch (v) {
case 1: found = 1; break; // 0: sale de un switch
default: break; // 0: sale de un switch
}
}
if (found != 0) break; // +1 break que sale del bucle exterior
}
return found;
}
Total: 3.
Cómo interpretarla
No tiene umbrales. Un método con varios saltos en sus bucles suele poder reescribirse extrayendo el cuerpo del bucle
a un método, con una condición de parada más clara o con cláusulas de guarda. Un solo continue de guarda al
principio de un bucle es un uso habitual y legible; la señal es el conjunto: varios saltos, bucles anidados y
etiquetas.
Relación con otras métricas
- «Número de sentencias de control» (
CONTROL): cuenta todos losbreakycontinue, también los de losswitch, además de las demás sentencias de control. - «Número de sentencias de bucle» (
LOOP): los bucles en los que ocurren estos saltos. - «Profundidad de anidamiento de bucles» (
LOOP_NEST): lo difícil que se vuelve un salto con etiqueta cuanto más anidados están los bucles. - «Complejidad ciclomática esencial» (
ev(G)): sube con los saltos que rompen la estructura del método.
En las herramientas
Stau Metro (NumBranchStatements, a nivel de método). Suma:
- todos los
continue; - todos los
breakcon etiqueta, salgan de lo que salgan (de un bucle, de unswitcho de un bloque etiquetado); - los
breaksin etiqueta cuya sentencia de salida no es unswitchclásico o con flechas, es decir, los que cortan un bucle.
yield y return no cuentan. Los saltos de las lambdas y de las clases anónimas o locales declaradas dentro del
método se suman al método que las contiene. No se calcula para los métodos abstractos. Los saltos que cuenta son
los mismos que la complejidad ciclomática esencial de Stau Metro considera no estructurados.