Share via


Diretivas de pré-processador

As políticas de pré-processador, como #define e #ifdef, normalmente são usadas para tornar os programas de origem mais fáceis de alterar e compilar 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 linhas do pré-processador são reconhecidas e executadas antes de expansão macro. Portanto, se uma macro se expandir até algo que se pareça com um comando do pré-processador, esse comando não será 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

#error

#import

#undef

#elif

#if

#include

#using

#else

#ifdef

#line

#endif

#ifndef

#pragma

 

A tecla de cerquilha (#) deve ser o primeiro caractere de espaço não em branco na linha que contém a política; os caracteres de espaço em branco podem aparecer entre a tecla de cerquilha e a primeira letra da política. 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é-processamento podem ser continuadas pela predecessão imediata do marcador de final de linha de uma barra invertida (\).

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

Consulte também

Referência

Operadores de pré-processador

Macros predefinidas

Outros recursos

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