variávelNuméricoObligatorio
Variable o elemento de array utilizado como contador. Es preferible declararlo explícitamente como Local.
COMANDOPublicado
FOR ... NEXT
FOR <variável> := <inicial> TO <final> [STEP <incremento>] ... NEXTRepite un bloque de comandos una cantidad determinada de veces utilizando una variable como contador.
Descripción general
FOR ... NEXT ejecuta repetidamente los comandos delimitados por FOR y NEXT. El contador comienza en el valor inicial, avanza según STEP — o 1 si se omite — y termina después de superar el límite final. Un STEP negativo permite recorrer valores en orden descendente. EXIT finaliza el bucle y LOOP continúa con la siguiente iteración.
Sintaxis
FOR <variável> := <inicial> TO <final> [STEP <incremento>] ... NEXTParámetros
inicialNuméricoObligatorio
Valor inicial del contador, evaluado cuando comienza el bucle.
finalNuméricoObligatorio
Límite final del contador, evaluado cuando comienza el bucle.
incrementoNuméricoOpcional
Valor sumado al contador en cada iteración. Puede ser negativo y su expresión se reevalúa cada vez.
Predeterminado:1Recorrido ascendente con STEP
User Function ExPares()
Local nNumero
Local nSuma := 0
For nNumero := 0 To 100 Step 2
nSuma += nNumero
Next
MsgInfo("Suma de pares: " + CValToChar(nSuma))
ReturnResultado esperado
El contador comienza en cero y avanza de dos en dos. Al final, nSuma contiene la suma de los números pares entre 0 y 100.
Recorrido descendente
User Function ExContagem()
Local nContador
For nContador := 5 To 1 Step -1
ConOut("Contagem: " + CValToChar(nContador))
Next
ReturnResultado esperado
STEP -1 reduce el contador en cada iteración y produce 5, 4, 3, 2 y 1.
Control con LOOP y EXIT
User Function ExControle()
Local nItem
For nItem := 1 To 20
If nItem % 2 != 0
Loop
EndIf
If nItem > 10
Exit
EndIf
ConOut(CValToChar(nItem))
Next
ReturnResultado esperado
LOOP ignora los valores impares. EXIT termina el procesamiento cuando se alcanza el primer número par mayor que 10.
- Declara el contador como Local antes de FOR para hacer explícito su ámbito.
- Utiliza STEP negativo cuando el valor inicial sea mayor que el final.
- Utiliza EXIT cuando una condición permita terminar la búsqueda antes del límite.
- Utiliza LOOP para ignorar el resto del bloque y continuar con la siguiente iteración.
- Mantén corto el cuerpo del bucle o extrae reglas extensas a funciones auxiliares.
- Cambiar las variables utilizadas como límites inicial o final dentro del bucle no recalcula los límites ya evaluados al inicio.
- Cambiar directamente el contador afecta la progresión y puede modificar el número de iteraciones.
- Un STEP incompatible con la dirección esperada puede impedir la ejecución o producir un comportamiento incorrecto.
- Si el contador no existe, la documentación indica que puede crearse implícitamente como Private, dificultando identificar errores y dependencias de ámbito.