Estruturas Condicionais do Pré-processador do Assembly NASM

O pré-processador do NASM permite a execução condicional de ações com base em certas condições, de forma análoga às estruturas if-else de linguagens de alto nível. Essas diretivas são processadas antes da montagem, alterando o código fonte que será efetivamente compilado.

A Estrutura %if...%endif

A diretiva %if verifica se uma condição é verdadeira. Se for, o bloco de código entre %if e %endif é incluído no arquivo final.

A sintaxe básica é:

%if condicao
    ; código a ser incluído se a condição for verdadeira
%endif

Por exemplo:

global _start

%define STATUS_CODE 22

section .text
_start:

%if STATUS_CODE == 22
    mov rdi, 44
%endif
    mov rax, 60
    syscall

Neste caso, a condição STATUS_CODE == 22 é verdadeira. Portanto, o pré-processador incluirá a linha mov rdi, 44. O código que o montador receberá será:

global _start

section .text
_start:
    mov rdi, 44
    mov rax, 60
    syscall

As condições podem usar os seguintes operadores:

• Igualdade: ==
• Diferença: !=
• Comparação: <, <=, >, >=
• Lógicos: && (E lógico), || (OU lógico)

Exemplo com operadores lógicos:

%define STATUS_CODE 22

%if STATUS_CODE != 23 && STATUS_CODE > 10
mov rdi, 41
%endif

A condição é verdadeira, pois STATUS_CODE não é 23 E é maior que 10.

Alternativas com %else e %elif

A diretiva %else permite definir um bloco de código alternativo que será incluído se a condição %if for falsa.

global _start

%define STATUS_CODE 22

section .text
_start:

%if STATUS_CODE == 23
    mov rdi, 23       ; Se STATUS_CODE for 23, rdi recebe 23
%else
    mov rdi, 46       ; Caso contrário, rdi recebe 46
%endif
    mov rax, 60
    syscall

Para encadear múltiplas condições, a diretiva %elif (abreviação de "else if") é utilizada.

global _start

%define STATUS_CODE 22

section .text
_start:

%if STATUS_CODE == 21
    mov rdi, 1
%elif STATUS_CODE == 22
    mov rdi, 2
%elif STATUS_CODE == 23
    mov rdi, 3
%else
    mov rdi, 4
%endif
    mov rax, 60
    syscall

O pré-processador avaliará cada condição em ordem e incluirá o código do primeiro bloco cuja condição for verdadeira.

Compilação Condicional com %ifdef

A diretiva %ifdef é uma ferramenta para compilação condicional. Ela verifica se um determinado símbolo de pré-processador foi definido, independentemente do seu valor. Se o símbolo existir, o bloco de código correspondente é incluído na compilação.

Isso é extremamente útil para habilitar ou desabilitar funcionalidades, como código de depuração (debug) ou recursos específicos para uma plataforma.

global _start

%define DEBUG_MODE 1

section .data
%ifdef DEBUG_MODE
    debug_message: db "Debug ativado", 10, 0
%endif

section .text
_start:

%ifdef DEBUG_MODE
    ; Aqui iria o código para imprimir a debug_message
%endif
    mov rax, 60
    syscall

Neste exemplo, como o símbolo DEBUG_MODE está definido, a variável debug_message será criada na seção de dados e o código de depuração na seção de texto será incluído. Se a linha %define DEBUG_MODE 1 fosse comentada ou removida, todo o código dentro dos blocos %ifdef seria ignorado pelo pré-processador.

Resumo

• As diretivas %if, %elif e %else permitem que o pré-processador inclua blocos de código com base na avaliação de condições, de forma semelhante a um if-else tradicional.
• A diretiva %ifdef é usada para compilação condicional, verificando se um símbolo foi definido, o que é ideal para controlar a inclusão de seções de código inteiras, como funcionalidades de depuração.