Препроцессор — это программа (или чаще — часть компилятора), которая преобразует исходный текст непосредственно перед компиляцией. К примеру, если Вы используете какой-либо кусок кода довольно часто, можно дать ему некое имя и заставить препроцессор повсеместно заменять это имя в исходном тексте на соответствующий ему код.
Другой пример — Вы хотите имитировать инструкцию, которая на самом деле не существует. В таком случае препроцессор может заменять её последовательностью инструкций дающих желаемый эффект.
Препроцессор просматривает исходный текст и заменяет некоторые вещи другими. Но как объяснить препроцессору, что именно он должен делать? Для этих целей существуют директивы препроцессора. О них мы и будем говорить.
Препроцессор понятия не имеет о инструкциях, директивах компилятора и прочих подобных вещах. Для него существуют собственные команды, и он игнорирует всё остальное.
Подобно большинству ассемблеров, комментарии в FASM начинаются с точки с запятой
;
. Всё, что следует за этим символом до конца строки игнорируется и удаляется из исходника.
К примеру, исходный текст
; заполним 100h байтов адресуемых EDI нулями
xor eax, eax ; обнуляем eax
mov ecx, 100h/4
rep stosd
после препроцессора превращается в
xor eax,eax
mov ecx,100h/4
rep stosd
ПРИМЕЧАНИЕ:
;
можно рассматривать как директиву препроцессора, удаляющую текст начиная с этого символа до конца строки.
ПРИМЕЧАНИЕ: Строка, полностью состоящая из комментария не будет удалена. Она становится пустой строкой (см. пример выше). Это будет важно в дальнейшем.
Если строка выглядит слишком длинной, возможно разделить её на несколько, используя символ
\
. При обработке препроцессором следующая строка будет добавлена к текущей.
Например:
db 1, 2, 3,\
4, 5, 6,\
7, 8, 9
будет преобразовано в:
db 1,2,3,4,5,6,7,8,9
Конечно,
\
в составе текстовой строки или комментария не вызовет объединения строк. Внутри текстовой строки этот символ воспринимается как обычный ASCII символ (как и всё остальное заключённое между кавычками '
или "
). Комментарии же удаляются без анализа того, что в них написано.
В строке после символа
\
могут быть только пробелы или комментарии.
Ранее, я упоминал, что строка, состоящая только из комментария не удаляется, а заменяется на пустую строку. Это значит, что код, подобный этому:
db 1, 2, 3,\
; 4,5,6,\ - закомментировано
7, 8, 9
преобразуется в:
db 1, 2, 3
7, 8, 9
и вызовет ошибку. Выход из положения — помещать символ \ до комментария:
db 1, 2, 3,\
\; 4,5,6 - правильно закомментировано
7, 8, 9
в результате будет:
db 1, 2, 3, 7, 8, 9
как мы и хотели.
Синтаксис:
include 'file name'
Эта директива вставляет содержимое файла
file name
в исходный текст. Вставленный текст, естественно, тоже будет обработан препроцессором. Имя файла (и путь к нему, если он есть) должны быть заключены в кавычки "
или апострофы '
.
Например:
include 'file.asm'
include 'HEADERS\data.inc'
include '..\lib\strings.asm'
include 'C:\config.sys'
Можно также использовать переменные окружения ОС, помещая их имена между символами
%
:
include '%FASMINC%\win32a.inc'
include '%SYSTEMROOT%\somefile.inc'
include '%myproject%\headers\something.inc'
include 'C:\%myprojectdir%\headers\something.inc'