Diretivas de pré-processador

As diretivas de pré-processador, como #define e #ifdef, são usadas para tornar os programas de origem fáceis de alterar e compilar em diferentes ambientes de execução. As diretivas no arquivo de origem dizem ao pré-processador para tomar ações específicas. Por exemplo, o pré-processador pode substituir tokens no texto, inserir o conteúdo de outros arquivos no arquivo de origem ou suprimir a compilação de parte do arquivo removendo seções de texto. As diretivas de pré-processador são processadas antes da expansão macro. Portanto, se uma macro se expande para algo que se parece com um comando de pré-processador, ela não é reconhecida pelo pré-processador.

As instruções de pré-processador usam o mesmo conjunto de caracteres que as instruções de arquivo de origem, com a exceção de que as sequências de escape não são suportadas. O conjunto de caracteres usado nas instruções do pré-processador é o mesmo que o conjunto de caracteres de execução. O pré-processador também reconhece valores de caracteres negativos.

O pré-processador reconhece as seguintes diretivas:

#define
#elif
#else
#endif

#error
#if
#ifdef
#ifndef

#import
#include
#line
#warning

#pragma
#undef
#using

O sinal numérico (#) deve ser o primeiro caractere sem espaço em branco na linha que contém a diretiva. Caracteres de espaço em branco podem aparecer entre o sinal numérico e a primeira letra da diretiva. Algumas diretivas incluem argumentos ou valores. Qualquer texto que siga uma diretiva (exceto um argumento ou valor que faça parte da diretiva) deve ser precedido pelo delimitador de comentário de linha única (//) ou incluído em delimitadores de comentário (/* */). As linhas que contêm diretivas de pré-processador podem ser continuadas imediatamente antes do marcador de fim de linha com uma barra invertida (\).

As diretivas de pré-processador podem aparecer em qualquer lugar em um arquivo de origem, mas se aplicam apenas ao restante do arquivo de origem, depois de aparecerem.

Consulte também

Operadores de pré-processador
Macros predefinidas
Referência do pré-processador C/C++