Diretivas #if, #elif, #else E #endif (C/C++)

A política #if, com as políticas #elif, #else e #endif, controla a compilação de partes de um arquivo de origem. Se a expressão escrita (após #if) tiver um valor diferente de zero, o grupo de linhas imediatamente após a política #if será mantido na unidade de tradução.

Gramática

conditional :

if-part elif-parts opt else-part opt endif-line

if-part :

texto if-line

if-line :

#if constant-expression

#ifdef identifier

#ifndef identifier

elif-parts :

elif-line text

elif-parts elif-line text

elif-line :

#elif constant-expression

else-part :

texto else-line

else-line :

#else

endif-line :

#endif

Cada política #if em um arquivo de origem deve ser correspondida pela política de fechamento #endif. Qualquer número de políticas #elif pode aparecer entre as políticas #if e #endif, mas no máximo uma política #else é permitida. A política #else, se presente, deverá ser a última política antes de #endif.

As políticas #if, #elif, #else e #endif podem ser aninhadas nas partes de texto de outras políticas #if. Cada política aninhada #else, #elif ou #endif pertence à política #if precedente mais próxima.

Todas as políticas de compilação condicionais, como #if e #ifdef, devem ser correspondidas com políticas de fechamento #endif antes do fim do arquivo; caso contrário, uma mensagem de erro será gerada. Quando as políticas de compilação condicional estão contidas em arquivos de inclusão, elas devem satisfazer às mesmas circunstâncias: não deve haver nenhuma política de compilação condicional sem correspondência no fim do arquivo de inclusão.

A substituição de macro é executada na parte de linha de comando após um comando #elif, para que uma chamada de macro possa ser usada em expressão constante.

O pré-processador seleciona uma das ocorrências do texto fornecidas para processamento adicional. Um bloco especificado no texto pode ser qualquer sequência de texto. Ele pode ocupar mais de uma linha. Normalmente, texto é o texto de programa que possui significado para o compilador ou o pré-processador.

O pré-processador processa o texto selecionado e o passa para o compilador. Se o texto contiver políticas de pré-processamento, o pré-processador executa essas políticas. Somente os blocos de texto selecionados pelo pré-processador são compilados.

O pré-processador seleciona um único item de texto avaliando a expressão de constante após cada política #if ou #elif até encontrar uma expressão de constante verdadeira (diferente de zero). Ele seleciona todo o texto (incluindo outras políticas de pré-processamento que começam com #) até a #elif, a #else ou a #endifassociada.

Se todas as ocorrências de expressão constante forem falsas, ou se nenhuma política #elif aparecer, o pré-processador selecionará o bloco de texto após a cláusula #else. Se a cláusula #else for omitida e todas as instâncias de expressão constante no bloco #if forem falsas, nenhum bloco de texto será selecionado.

A expressão constante é uma expressão constante inteira com estas restrições adicionais:

As expressões devem ter o tipo integral e podem incluir apenas constantes de inteiros, constantes de caracteres e o operador defined.

A expressão não pode usar sizeof ou um operador de conversão de tipos.

O ambiente de destino talvez não consiga representar todos os intervalos de inteiros.

A tradução representa os tipos int, como long e unsigned int e como unsigned long.

O tradutor pode traduzir a constante de caracteres como um conjunto de valores de código diferentes do conjunto para o ambiente de destino. Para determinar as propriedades do ambiente de destino, verifique os valores das macros de LIMITS.H em um aplicativo compilado para o ambiente de destino.

A expressão não deve executar consultas ambientais e deve permanecer isolada de detalhes da implementação no computador de destino.

O operador do pré-processador defined pode ser usado em expressões de constantes especiais, como mostrado pela seguinte sintaxe:

defined( identifier )

defined identifier

Essa expressão constante será considerada verdadeira (diferente de zero) se o identificador estiver definido; caso contrário, a condição será falsa (0). Um identificador definido como texto vazio é considerado definido. A política defined pode ser usada em #if e em uma política #elif, mas em nenhum outro lugar.

No exemplo a seguir, as políticas #if e #endif controlam a compilação de uma de três chamadas de função:

#if defined(CREDIT)