Язык ассемблера - Макросы

Макрос — это механизм повторного использования кода, предоставляемый NASM, который позволяет раскрывать шаблоны кода во время компиляции, снижая необходимость многократно писать похожий код.


Что такое макрос

МакросЭто механизм текстовой замены во время компиляции, который раскрывается препроцессором ассемблера перед компиляцией.

В отличие от процедур, макросы не имеют накладных расходов CALL/RET — каждый раз, когда используется макрос, ассемблер напрямую копирует содержимое макроса в место использования.

Макрос не является вызовом функции и не имеет накладных расходов на стековый кадр; однако размер исполняемого файла увеличивается, потому что при каждом раскрытии создаётся копия кода.


Однострочный макрос: %define

%defineЭто однострочный макрос с простым синтаксисом:

Пример

; Пример однострочного макроса

; Определить константу
%define MAX_SIZE 256
%define APP_NAME 'example'

; Определить макрос с параметрами (макрофункция)
%define mul_by_2(x) (x * 2)
%define sum3(a, b, c) ((a) + (b) + (c))

section .text
    global _start

_start:
    mov eax, MAX_SIZE            ; eax = 256
    mov eax, mul_by_2(10)        ; eax = (10 * 2) = 20
    mov eax, sum3(1, 2, 3)       ; eax = ((1)+(2)+(3)) = 6

    ; Переопределение (%define можно изменить)
    %define MAX_SIZE 512
    mov eax, MAX_SIZE            ; eax = 512

    ; Отменить определение
    %undef MAX_SIZE
    ; mov eax, MAX_SIZE ; Ошибка: MAX_SIZE не определён

    mov eax, 1
    mov ebx, 0
    int 0x80

%defineРаскрытие макроса — это чистая текстовая замена. Например,mul_by_2(2+3)раскрывается в(2+3 * 2), из-за приоритета операторов результат не 10, а 8. Вот почему параметры макроса должны быть заключены в круглые скобки.


Многострочный макрос: %macro / %endmacro

%macroИспользуется для определения сложных макросов, содержащих несколько инструкций:

Пример

; Путь к файлу: macro_multi.asm
; Пример многострочного макроса

; Определение макроса: выход из программы
; Параметр argc: сколько параметров принимает макрос
%macro exit_program 1
    mov eax, 1                   ; sys_exit
    mov ebx, %1                  ; Первый параметр используется как код выхода
    int 0x80
%endmacro

; Определение макроса: печать строки
; Принимает 2 параметра: адрес строки, длина
%macro print_string 2
    push eax
    push ebx
    push ecx
    push edx
    mov eax, 4                   ; sys_write
    mov ebx, 1                   ; stdout
    mov ecx, %1                  ; Адрес строки
    mov edx, %2                  ; Длина строки
    int 0x80
    pop edx
    pop ecx
    pop ebx
    pop eax
%endmacro

section .data
    msg db 'Hello, EXAMPLE!', 0xA
    msg_len equ $ - msg

section .text
    global _start

_start:
    print_string msg, msg_len     ; Используйте макрос для вывода сообщения
    print_string msg, msg_len     ; Вызовите снова
    exit_program 0                ; Выход из программы

Расширенное использование параметров макроса

Макросы NASM поддерживают параметры по умолчанию, подсчёт параметров и условное раскрытие:

Пример

; Пример расширенных параметров макроса

; Макрос с параметрами по умолчанию (диапазон параметров 2-3)
%macro debug_print 2-3 1        ; Не менее 2 параметров, не более 3, 3-й по умолчанию равен 1
    %if %3 = 1                   ; Если 3-й параметр = 1 (режим отладки включён)
        push eax
        push ebx
        push ecx
        push edx
        mov eax, 4
        mov ebx, 1
        mov ecx, %1
        mov edx, %2
        int 0x80
        pop edx
        pop ecx
        pop ebx
        pop eax
    %endif
%endmacro

; Макрос с переменным числом параметров
%macro push_registers 1-*        ; От 1 до любого количества параметров
    %rep %0                      ; %0 — количество параметров
        push %1                  ; Развернуть 1-й
        %rotate 1                ; Сдвинуть список параметров влево
    %endrep
%endmacro

section .text
    global _start

_start:
    ; Используйте push_registers для сохранения нескольких регистров
    push_registers eax, ebx, ecx, edx
    ; Разворачивается в:
    ; push eax
    ; push ebx
    ; push ecx
    ; push edx

    ; Соответственно pop
    pop edx
    pop ecx
    pop ebx
    pop eax

    mov eax, 1
    mov ebx, 0
    int 0x80

Локальные метки в макросах

В макросах используйте%%labelдля определения локальных меток, избегая конфликтов меток при многократных развёртываниях:

Пример

; Локальные метки в макросах

; Сравнить два значения и установить минимум
%macro min_val 2
    mov eax, %1
    mov ebx, %2
    cmp eax, ebx
    jle %%skip                   ; ★ Локальная метка, для каждого развёртывания создаётся уникальное имя
    mov eax, ebx
%%skip:
%endmacro

; Если локальные метки не используются, после двух раскрытий появляются дублирующиеся метки skip
section .text
    global _start

_start:
    min_val 10, 5               ; eax = 5
    min_val eax, 3              ; eax = 3

    mov eax, 1
    mov ebx, 0
    int 0x80

Раскрытие обычной метки дважды в макросе вызывает ошибку конфликта имён меток. Локальные метки%%labelзаставляют NASM генерировать уникальное имя метки для каждого раскрытия (например,..@0001.skip), избегая конфликтов.


Сравнение макросов и процедур

ХарактеристикаМакросПроцедура
Способ реализацииТекстовое развёртывание на этапе компиляцииCALL/RET во время выполнения
Накладные расходы выполненияНет накладных расходов на вызов (прямое встраивание)Есть накладные расходы CALL/RET (примерно несколько тактов)
Размер кодаКаждое развёртывание увеличивает размер кодаОдна копия кода, вызываемая несколько раз
Типы параметровПроизвольный текст (регистры, непосредственные значения, память)Значения времени выполнения
ОтладкаСложно (нет трассировки после развёртывания)Просто (есть стек вызовов функций)
Применимые сценарииКороткий, часто вызываемый код с гибкой типизациейФункции со сложной логикой и большим размером кода

Условная компиляция: %if / %elif / %else / %endif

Макропрепроцессор поддерживает условную компиляцию, которая позволяет выбирать и генерировать разный код на основе определений символов:

Пример

; Путь к файлу: cond_compile.asm
; Пример условной компиляции: режимы отладки и релиза

%define DEBUG 1                  ; 1=режим отладки, 0=режим релиза

section .data
    msg db 'Программа выполняется...', 0xA
    msg_len equ $ - msg
    debug_msg db '[DEBUG] Вход в функцию', 0xA
    debug_len equ $ - debug_msg

section .text
    global _start

_start:
    %if DEBUG = 1
        ; Режим отладки: вывод отладочной информации
        mov eax, 4
        mov ebx, 1
        mov ecx, debug_msg
        mov edx, debug_len
        int 0x80
    %endif

    ; Обычная бизнес-логика
    mov eax, 4
    mov ebx, 1
    mov ecx, msg
    mov edx, msg_len
    int 0x80

    mov eax, 1
    mov ebx, 0
    int 0x80

Типичные сценарии условной компиляции:

СценарийПример
Переключение Debug/Release%if DEBUG / %else / %endif
Адаптация под платформу%ifdef LINUX / %ifdef WINDOWS
Переключатели функцийУправление функциями в зависимости от того, определён ли символ

%rep Блок повторения

%repИспользуется для генерации повторяющегося кода или данных:

Пример

; %rep пример блока повторения

section .data
    ; Сгенерировать таблицу поиска размером 256 байт
    ; 0, 1, 4, 9, 16, 25, ... (таблица квадратов чисел)
    %assign i 0
    ; Здесь %rep нельзя использовать для генерации таблицы квадратов при сложных вычислениях
    ; Простой пример: сгенерировать таблицу ASCII для 0-9
    digits: db '0', '1', '2', '3', '4', '5', '6', '7', '8', '9'

section .text
    global _start

_start:
    ; %rep повторяет инструкции в коде
    mov eax, 0
    %rep 5                      ; Повторить 5 раз
        inc eax                  ; eax увеличивается на 1 каждый раз
    %endrep
    ; eax = 5

    mov ebx, eax
    mov eax, 1
    int 0x80

Чрезмерное использование макросов делает код трудным для чтения и отладки. Когда тело макроса превышает 10 строк, рассмотрите переход на вызов процедуры. В критичных к производительности горячих участках эффект встраивания коротких макросов имеет очевидные преимущества.

Другие расширения