Partilhar via


Diretivas de pré-processador

Diretivas de pré-processamento, como #define e # ifdef, geralmente são usados para fazer com que os programas de origem fácil alterar e compilar em ambientes de execução diferente.As diretivas no arquivo de origem informam o pré-processador para executar ações específicas.Por exemplo, o pré-processador pode substituir símbolos 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.Linhas do pré-processador são reconhecidas e realizadas antes da expansão de macro.Portanto, se uma macro se expande em algo parecido com um comando de pré-processamento, esse comando não é reconhecido no pré-processador.

Instruções do pré-processador usam o mesmo conjunto de caracteres como instruções do arquivo de origem, com exceção de que não há suporte para seqüências de escape.O conjunto de caracteres usado em instruções do pré-processador é igual a conjunto de caracteres de execução.O pré-processador também reconhece os valores de caracteres negativos.

O pré-processador reconhece as seguintes diretivas:

# define

# Error

# Import

#undef

# elif

# IF

# include

# using

# else

# ifdef

# line

# endif

# ifndef

# pragma

 

O sinal numérico (#) deve ser o primeiro caractere de espaço em nonwhite 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 diretivas incluem valores ou argumentos.Qualquer texto que segue uma diretiva (exceto um argumento ou um valor que é parte da diretiva) deve ser precedido pelos delimitadores de comentários de linha única (/ /) ou colocados entre os delimitadores de comentário (/ * * /).Linhas que contêm diretivas de pré-processamento podem ser continuadas precedendo imediatamente o marcador de fim-de-linha com uma barra invertida (\).

Diretivas de pré-processamento podem aparecer em qualquer lugar em um arquivo de origem, mas se aplicam somente ao restante do arquivo de origem.

Consulte também

Referência

Operadores de pré-processador

Macros predefinidas

Outros recursos

Referência de pré-processador de C/C++