Protheus :: Programação Básica em Advpl “Combo XVIII”

Pré-Processador:

O pré-processador é um importante recurso no Advpl. Imagine-o como um programa que executa antes do compilador. Ele lê o programa como entrada e gera um arquivo pré-processado como saída. O arquivo de saída, então, serve como a entrada do compilador.

Podemos incluir comandos do pré-processador, chamadas de diretivas, no programa de origem. O pré-processador as manipulará; o compilador nunca as percebe, uma vez que ele só manipula o arquivo de saída.

O pré-processador do Advpl tem os seguintes recursos:

- constantes simbólicas ou manifestas
- arquivos include
- macros do compilador
- compilação condicional
- comandos definidos pelo usuário

Constantes Simbólicas:

No Advpl é possível a definição de constantes simbólicas para uso no processo de pré-compilação. Devemos abrir mão desse recurso para tornar os programas mas legíveis e fácil de entender. Por Exemplo, no fragmento de codificação:

IF ( nOpc == 1 )
Inclui()
ElseIF ( nOpc == 2 )
Altera()
ElseIF ( nOpc == 3 )
Exclui()
EndIF

Só conseguiremos identificar o que nOpc representa se acompanharmos todo o processo ou se o programa estiver documentado. Mas, se utilizássemos constantes, teríamos:

Obs.: Podemos definir constates com a diretiva do pré-processador #DEFINE.

#DEFINE INCLUI 1
#DEFINE ALTERA 2
#DEFINE EXCLUI 3

IF ( nOpc == INCLUI )
Inclui()
ElseIF ( nOpc == ALTERA )
Altera()
ElseIF ( nOpc == EXCLUI )
Exclui()
EndIF

Não precisaríamos avaliar todo o programa para saber a que se refere o valor de nOpc. E o código fica muito mais fácil de interpretar. Na realidade INCLUI, ALTERA e EXCLUI, serão substituídos no processo de pré-compilação por 1 , 2 e 3 ( respectivamente ).

Regra: A tradução de #DEFINE feita pelo pré-processador é sensível a letras maiúsculas e minúsculas.

Dica: Defina todas as constantes em letras maiúsculas com a diretiva #DEFINE