Язык ассемблера - Макросы
Макрос — это механизм повторного использования кода, предоставляемый 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Используется для определения сложных макросов, содержащих несколько инструкций:
Пример
; Пример многострочного макроса
; Определение макроса: выход из программы
; Параметр 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
Макропрепроцессор поддерживает условную компиляцию, которая позволяет выбирать и генерировать разный код на основе определений символов:
Пример
; Пример условной компиляции: режимы отладки и релиза
%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Используется для генерации повторяющегося кода или данных:
Пример
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 строк, рассмотрите переход на вызов процедуры. В критичных к производительности горячих участках эффект встраивания коротких макросов имеет очевидные преимущества.