Diretivas do pré-processador

Diretivas de pré-processador, como #define e #ifdef, são usadas para facilitar a alteração e compilação de programas de origem em diferentes ambientes de execução. As políticas no arquivo de origem mandam o pré-processador realizar 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 da macro. Portanto, se uma macro se expandir até algo que se pareça com um comando do pré-processador, o comando não é reconhecido pelo pré-processador.

As instruções do pré-processador usam o mesmo conjunto de caracteres das instruções de arquivo de origem, com exceção das sequências de escape, que não têm suporte. O conjunto de caracteres usado em instruções do pré-processador é igual ao conjunto de caracteres de execução. O pré-processador também reconhece valores negativos de caracteres.

O pré-processador reconhece as políticas a seguir:

#define
#elif
#else
#endif

#error
#if
#ifdef
#ifndef

#import
#include
#line
#warning

#pragma
#undef
#using

A tecla de sustenido (#) deve ser o primeiro caractere de espaço não em branco na linha que contém a diretiva. Caracteres de espaço em branco podem aparecer entre o sinal de número e a primeira letra da diretiva. Algumas políticas incluem argumentos ou valores. Qualquer texto que segue uma política (exceto um argumento ou um valor que é parte da política) deve ser precedido pelo delimitador de comentário de linha única (//) ou ser incluído em delimitadores de comentário (/* */). As linhas que contêm políticas de pré-processador podem ser continuadas inserindo uma barra invertida (\) imediatamente antes do marcador de fim da linha.

As políticas do pré-processador podem aparecer em qualquer lugar do arquivo de origem, mas se aplicam somente ao restante do arquivo de origem, depois que ele aparece.

Confira também

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