FOR ... NEXT

Sintaxe

FOR <variável> := <expressão inicial> TO <expressão final> [ STEP <expressão incremental> ]

          ...

          < instruções >

          ...

          [ LOOP ]

          ...

          [ EXIT ]

          ...

          < instruções >

          ...

NEXT <variável>

Propósito

O comando FOR ... NEXT permite a repetição de um bloco de instruções por um determinado número de vezes, avaliado por um contador incrementado automaticamente através de uma expressão
numérica.

Argumentos

<variável >

Define o nome da variável de memória que será utilizada como contador para realizar o controle do número de repetições. Se a variável especificada não existir ou não for visível, será automaticamente criada uma variável privada.

<expressão inicial>

É uma expressão numérica que define o valor inicial a ser assumido pela variável de controle ou contador.

TO <expressão final>

É uma expressão numérica que define o valor final (máximo ou mínimo) que poderá ser assumido pela variável de controle ou contador.

STEP <expressão incremental>

Define o incremento da variável de controle. Cada vez que é completado um ciclo de repetição, a variável de controle ou contador é incrementada através do resultado da expressão incremento, que deve ser numérica.

O incremento poderá ser positivo ou negativo. Se for positivo, a expressão final deve ser maior que a expressão inicial, pois o contador será crescente. Se for negativo, a expressão final deve ser menor que a expressão inicial, pois o contador será decrescente. Caso este argumento não seja especificado, será assumido automaticamente um incremento igual à 1 (um) a cada ciclo completado.

EXIT

Finaliza a repetição, desviando incondicionalmente o fluxo de execução do programa para a primeira linha de instrução após o NEXT.

LOOP

Reinicia um ciclo de repetição a partir de um ponto intermediário do bloco de instruções contido num FOR ... NEXT, evitando que uma parte das instruções deste bloco seja executada. Portanto, reinicia o bloco de instruções mesmo não tendo atingido o NEXT.

Utilização

Cada vez que uma repetição é iniciada, o AdvPL reavalia todas as expressões que definem o controle do FOR ... NEXT, o que o caracteriza como dinâmico. Isto significa que é possível alterar os seus limites e parâmetros modificando os valores envolvidos nas expressões, mesmo durante a execução do FOR ... NEXT.

Dicas

Este comando é especialmente útil para a manipulação de arrays. O contador poderá ser utilizado como índice para processar todos os seus elementos.

A estrutura FOR ... NEXT pode ser intercalada dentro de qualquer outra estrutura de programação, inclusive dentro de outros FOR ... NEXT. Não há limite de níveis. A única exigência é que cada estrutura de controle seja corretamente intercalada. Isto é, o início e o fim de cada estrutura de controle devem estar contidos dentro do início e do fim de outras de menor nível.

Exemplos

O exemplo abaixo apresenta os valores do contador nCont, que será incrementado de -3 em -3:

FOR nCont := 15 TO 0 STEP -3

          MSGALERT( nCont )

NEXT nCont

O resultado será 15, 12, 9, 6, 3 e 0.

O exemplo abaixo permite a visualização dos valores contidos nos elementos de um array:

nNumElem := LEN(aVetor)

FOR nElem := 1 To nNumElem

          MSGALERT( aVetor[nElem] )

NEXT nElem