Директивы изменения формата листинга

Директивы этой группы позволяют управлять форматом файла листинга.

.PAGE
Директива .PAGE задает высоту и ширину страницы файла листинга и начинает его новую страницу. Она имеет следующий синтаксис:

PAGE [число_строк][,число_столбцов] PAGE +

Здесь:

· число_строк задает число строк, выводимых на странице листинга;

· число столбцов находится в диапазоне 59...255 и задает число столбцов на странице.

Если опустить один из этих параметров, то текущая установка данного параметра останется без изменений. Для изменения только числа столбцов необходимо указать перед этим параметром запятую. С помощью директивы. PAGE можно разбивать листинг на разделы, в пределах которых нумерация начинается с нуля. Так, при указании после директивы .PAGE символа “+” начинается новая страница, номер раздела увеличивается, а номер страницы снова устанавливается в 1. Если использовать директиву .PAGE без аргументов, то листинг возобновляется с новой страницы без изменения номера раздела.

%PAGESIZE (.PAGESIZE)
Директива %PAGESIZE работает так же, как и директива .PAGE, но, в отличие от последней, она не начинает новую страницу, а лишь определяет ее параметры:

%PAGESIZE [число_строк][,число_столбцов]

%NEWPAGE
Директива %NEWPAGE работает аналогично директиве .PAGE без аргументов. Строки исходного текста после директивы %NEWPAGE будут начинаться с новой страницы.

%BIN
Директива %BIN устанавливает длину поля объектного кода в файле листинга. Ее синтаксис:

%BIN размер

Здесь размер — некоторая константа.
По умолчанию поле объектного кода занимает в файле листинга до 20 позиций.

%DEPTH
Директива %DEPTH устанавливает размер поля глубины в файле листинга. Ее синтаксис:

%DEPTH размер

Здесь размер задает количество столбцов в поле глубины листинга.
Напомню, что данное поле показывает уровень вложенности включаемых файлов (INCLUDE) и макрорасширений. Если указать в качестве размера значение 0, то поле уровня вложенности не выводится. По умолчанию это поле имеет значение 1.

%LINENUM
Директива %LINENUM позволяет задать размер поля занимаемого номерами строк в файле листинга:

%LINENUM размер

По умолчанию под номер строки отводятся четыре столбца.

%TRUNC и %NOTRUNC
Директивы %TRUNC и %NOTRUNC предназначены для усечения длинных полей листинга. Их синтаксис:

%TRUNC и %NOTRUNC

Если некоторая строка исходного кода получается слишком длинной, то она автоматически усекается. Если возникает необходимость увидеть всю генерируемую строку, то можно использовать директиву %NOTRUNC, действие которой будет заключаться в том, что слишком длинная строка будет переноситься на следующую строку. Для включения режима усечения нужно использовать директиву %TRUNC. Такие переключения можно осуществлять неограниченное количество раз.

%PCNT
Директива %PCNT задает размер поля “сегмент:смещение” в файле листинга. Ее синтаксис:

%PCNT размер

Здесь размер — число столбцов, которое необходимо отвести для смещения в текущем ассемблируемом сегменте.
По умолчанию TASM устанавливает размер, равный 4 для обычных 16-битных сегментов (атрибут размера адреса use16) и 8 для 32-битных сегментов (атрибут размера адреса use32). Директива %PCNT позволяет переопределить эти используемые по умолчанию значения.

%TITLE
Директива %TITLE задает заголовок файла листинга. Ее синтаксис:

%TITLE “текст”

Здесь текст — строка, которая будет выводиться в верхней части каждой страницы после имени исходного файла и перед заголовком, заданным по директиве %SUBTTL.
В отличие от других директив, %TITLE можно использовать в программе только один раз.

%SUBTTL
Директива %SUBTTL задает подзаголовок файла листинга. Ее синтаксис:

%SUBTTL “текст”

Подзаголовок представляет собой текст, который выводится в верхней части каждой страницы после имени исходного файла и после заголовка, заданного директивой %TITLE. Директиву %SUBTTL можно указывать в программе столько раз, сколько необходимо. Каждая директива изменяет подзаголовок, который будет выводиться на следующей странице листинга.

%TABSIZE
Директива %TABSIZE задает позицию табуляции в файле листинга. Ее синтаксис:

%TABSIZE размер

Здесь размер — число столбцов между двумя позициями табуляции в файле листинга (по умолчанию 8 столбцов).

%TEXT
Директива %TEXT используется для задания длины поля исходного текста в файле листинга. Ее синтаксис:

%TEXT размер

Здесь размер — число столбцов, используемых для вывода исходных строк. Если размер строки превышает длину этого поля, то строка будет либо усекаться, либо переноситься на следующую строку, в зависимости от директив %TRUNC или %NOTRUNC.