A compilação condicional é um recurso poderoso do pré-processador C que permite incluir ou excluir partes do código durante a compilação, com base em condições definidas em tempo de compilação. Isso é feito por meio de diretivas como #ifdef, #ifndef, #if, #else e #endif. Essas diretivas são processadas antes da compilação propriamente dita, permitindo que você crie código mais flexível, portátil e eficiente.

Nesta aula, vamos mergulhar nos detalhes dessas diretivas, entender como funcionam e como aplicá-las em situações reais. Você verá como a compilação condicional pode ser usada para adaptar o código a diferentes plataformas, ativar ou desativar funcionalidades e melhorar a organização do projeto.

#ifdef, #ifndef, #if

A diretiva #ifdef (abreviação de "if defined") verifica se um determinado macro (ou identificador) foi definido anteriormente com #define. Se estiver definido, o código entre #ifdef e o correspondente #endif é incluído na compilação; caso contrário, é ignorado. Por exemplo:

#define DEBUG

#ifdef DEBUG
    printf("Modo debug ativo\n");
#endif

Nesse caso, a mensagem será impressa porque DEBUG está definido. Se removermos a linha #define DEBUG, o código dentro do bloco #ifdef será omitido.

A diretiva #ifndef ("if not defined") é o oposto: o código é incluído se o macro não estiver definido. Isso é muito útil para evitar inclusões duplicadas de cabeçalhos, como veremos na seção de include guards. Exemplo:

#ifndef CONFIG_H
#define CONFIG_H
// conteúdo do cabeçalho
#endif

A diretiva #if avalia uma expressão constante. Se a expressão for diferente de zero (verdadeira), o código é incluído. A expressão pode usar constantes, macros e operadores como ==, <, >, &&, ||, etc. Por exemplo:

#if VERSION > 2
    printf("Versão maior que 2\n");
#endif

É importante que a expressão seja avaliada em tempo de compilação, portanto não pode conter variáveis ou chamadas de função.

#else e #endif

A diretiva #else pode ser usada para fornecer um bloco alternativo quando a condição do #if, #ifdef ou #ifndef não for satisfeita. Assim como no if da linguagem C, #else captura todos os casos não cobertos pela condição anterior. Exemplo:

#ifdef WINDOWS
    #include <windows.h>
#else
    #include <unistd.h>
#endif

Aqui, se WINDOWS estiver definido, incluímos windows.h; caso contrário, incluímos unistd.h. Isso é comum para manter portabilidade entre sistemas operacionais.

A diretiva #endif encerra um bloco condicional iniciado por #if, #ifdef ou #ifndef. É obrigatória para cada bloco aberto; não pode ser omitida. É uma boa prática comentar o #endif com a condição correspondente para facilitar a leitura, especialmente em blocos longos:

#ifdef DEBUG
    // muitas linhas de código
#endif /* DEBUG */

Também é possível encadear múltiplas condições com #elif (abreviação de "else if"), que funciona de forma semelhante ao else if da linguagem. Exemplo:

#if PLATFORM == 1
    printf("Plataforma 1\n");
#elif PLATFORM == 2
    printf("Plataforma 2\n");
#else
    printf("Outra plataforma\n");
#endif

Include guards

Include guards são um padrão de programação que usa #ifndef, #define e #endif para evitar que um arquivo de cabeçalho seja incluído mais de uma vez em uma mesma unidade de tradução. Isso é essencial porque a inclusão múltipla pode causar erros de redefinição de tipos, variáveis ou funções.

Um include guard típico tem a seguinte forma:

// arquivo: minha_biblioteca.h
#ifndef MINHA_BIBLIOTECA_H
#define MINHA_BIBLIOTECA_H

// declarações e definições

#endif /* MINHA_BIBLIOTECA_H */

Quando o pré-processador encontra #include "minha_biblioteca.h" pela primeira vez, o macro MINHA_BIBLIOTECA_H não está definido, então o conteúdo do arquivo é processado e o macro é definido. Em inclusões subsequentes, o macro já estará definido, fazendo com que o conteúdo seja pulado, evitando duplicação.

É importante escolher um nome único e significativo para o guard, geralmente baseado no nome do arquivo, em maiúsculas e com underscores. Isso reduz o risco de colisão com outros guards.

Casos de uso

A compilação condicional é amplamente utilizada no desenvolvimento de software em C. Aqui estão alguns casos comuns:

  • Código específico por plataforma: Adaptar o código para diferentes sistemas operacionais ou arquiteturas, como usar #ifdef _WIN32 para Windows e #ifdef __linux__ para Linux.
  • Depuração: Incluir código de log ou verificações apenas em builds de debug, usando #ifdef DEBUG.
  • Funcionalidades opcionais: Ativar ou desativar recursos em tempo de compilação, como suporte a um protocolo específico ou uso de bibliotecas externas.
  • Portabilidade: Escolher entre diferentes implementações de uma função, por exemplo, usando #ifdef USE_OPENGL vs #ifdef USE_VULKAN.
  • Include guards: Como já vimos, para proteger cabeçalhos contra inclusão múltipla.

Um exemplo prático de código específico por plataforma:

#ifdef _WIN32
    #include <windows.h>
    #define CLEAR_SCREEN() system("cls")
#else
    #include <stdlib.h>
    #define CLEAR_SCREEN() system("clear")
#endif

int main() {
    CLEAR_SCREEN();
    printf("Olá, mundo!\n");
    return 0;
}

Nesse exemplo, a macro CLEAR_SCREEN é definida de maneira diferente para Windows e sistemas Unix, permitindo que o mesmo código funcione em ambos.

Boas práticas

Ao usar compilação condicional, algumas boas práticas podem ajudar a manter o código limpo e sustentável:

  • Use nomes de macros claros e descritivos, geralmente em maiúsculas.
  • Comente o #endif com a condição correspondente para facilitar a leitura.
  • Evite aninhar muitas diretivas condicionais, pois isso pode tornar o código difícil de entender. Considere dividir em funções ou arquivos separados.
  • Prefira #if a #ifdef quando precisar avaliar valores, mas lembre-se de que macros indefinidas são tratadas como 0 em #if.
  • Mantenha o código dentro de blocos condicionais o mais curto possível.

Exercícios

  1. Explique a diferença entre #ifdef e #if. Dê um exemplo de cada.

    2. ✓ Resposta: #ifdef verifica se um macro está definido, independentemente de seu valor. #if avalia uma expressão constante. Por exemplo: 
    #define FEATURE 1
#ifdef FEATURE
    // incluído se FEATURE estiver definido
#endif
#if FEATURE == 1
    // incluído se FEATURE valer 1
#endif
  2. Crie um include guard para um cabeçalho chamado meu_modulo.h. Mostre o código completo.

    3. ✓ Resposta: 
    #ifndef MEU_MODULO_H
#define MEU_MODULO_H

// declarações e definições

#endif /* MEU_MODULO_H */
  3. Escreva um trecho de código que use #ifdef e #else para imprimir uma mensagem diferente se a macro DEBUG estiver definida ou não.

    4. ✓ Resposta: 
    #ifdef DEBUG
    printf("Modo debug ativo\n");
#else
    printf("Modo release\n");
#endif
  4. Considere o seguinte código. Quais linhas serão compiladas se PLATAFORMA estiver definido como 2? 
    #define PLATAFORMA 2
#if PLATAFORMA == 1
    printf("Plataforma 1\n");
#elif PLATAFORMA == 2
    printf("Plataforma 2\n");
#else
    printf("Outra\n");
#endif

    5. ✓ Resposta: Apenas printf("Plataforma 2\n"); será compilado, pois a condição #elif PLATAFORMA == 2 é verdadeira.
  5. Escreva um exemplo de uso de compilação condicional para incluir uma biblioteca diferente dependendo do sistema operacional (Windows vs Linux).

    6. ✓ Resposta: 
    #ifdef _WIN32
    #include <windows.h>
#else
    #include <unistd.h>
#endif

Referências