#defineDiretivaOpcional
Define identificadores, constantes manifiestas o pseudofunciones expandidas por el preprocesador.
FUNDAMENTOPublicado
Directivas de compilación en AdvPL
#define · #undef · #include · #ifdef · #ifndef · #else · #endif · #command · #translateControla el preprocesamiento, comparte definiciones y selecciona qué bloques llegan al compilador.
Descripción general
Las directivas se procesan antes de compilar. Una analogía útil es preparar una receta antes del horno: se incluyen cabeceras, se expanden símbolos, se traduce sintaxis y se seleccionan bloques; el compilador recibe el resultado. #define y #include son conceptualmente similares a C/C++, pero #include no es un sistema moderno completo de módulos.
Sintaxis
#define · #undef · #include · #ifdef · #ifndef · #else · #endif · #command · #translateParámetros
#undefDiretivaOpcional
Elimina una definición activa desde el punto donde aparece la directiva.
#includeDiretivaOpcional
Inserta un archivo de cabecera en el punto actual usando la ruta de includes.
#ifdefDiretivaOpcional
Incluye un bloque en la compilación solo cuando un identificador está definido.
#ifndefDiretivaOpcional
Incluye un bloque solo cuando un identificador todavía no está definido.
#else e #endifDiretivaOpcional
Define la alternativa y cierra bloques de compilación condicional.
#command e #translateDiretivaOpcional
Crea reglas de transformación sintáctica aplicadas por el preprocesador.
Constante y compilación condicional
#define LIMITE_ITENS 100
#define LOG_DETALHADO
User Function ExDiretivas()
Local nItens := 120
#ifdef LOG_DETALHADO
ConOut("Itens recebidos: " + CValToChar(nItens))
#endif
If nItens > LIMITE_ITENS
MsgAlert("Limite excedido")
EndIf
ReturnResultado esperado
Los símbolos se resuelven antes de compilar; If continúa siendo una decisión en ejecución.
Valor predeterminado con #ifndef
#ifndef TAMANHO_LOTE
#define TAMANHO_LOTE 50
#endif
User Function ExLote()
ConOut("Tamanho do lote: " + CValToChar(TAMANHO_LOTE))
ReturnResultado esperado
El valor se usa solo si no existe una definición anterior.
Include específico
#include "TOTVS.ch"
#include "FWMVCDef.ch"
User Function ExCabecalhos()
// Utilize símbolos do Framework MVC somente após incluir
// o cabeçalho compatível com o ambiente.
ReturnResultado esperado
El contenido de las cabeceras participa en el preprocesamiento.
- Las directivas actúan antes de ejecutar; If/Else decide mientras la rutina corre.
- Usa constantes manifiestas para evitar valores mágicos, compilación condicional solo cuando sea necesaria e includes compatibles.
- Usa configuración en ejecución para valores que deban cambiar sin recompilar.
- #command y #translate son avanzados; la claridad suele ser más importante que una nueva sintaxis.
- No pongas secretos en #define.
- Evita símbolos por cliente si los parámetros o extensiones resuelven el problema.
- No supongas que todo fuente necesita PROTHEUS.CH y TOTVS.CH.
- AAdd() es una función de biblioteca, no una invención de #command.