Директиви керування лістингом

Директиви керування лістингом поділяються на наступні групи:

• загальні директиви керування лістингом;

• директиви виводу в лістинг файлів, що включаються;

• директиви включення блоків умовного асемблювання;

• директиви включення в лістинг макрокоманд;

• директиви включення в лістинг інформації про перехресні посилання;

• директиви зміни формату лістингу

При розгляді директив необхідно звернути увагу на те, що їхній формат відрізняється для режимів роботи транслятора MASM і IDEAL:

• директивам режиму MASM передує крапка;

• директивам режиму IDEAL передує знак “%”.

Більшість директив не має операндів. Директиви, як і команди, задаються в окремому рядку в тому місці програми, з якого повинна початися їхня дія. 

Загальні директиви керування лістингом

Директиви цієї групи призначені для керування видом файлу лістингу. Усі директиви є парними - це означає, що якщо одна директива щось дозволяє, то інша, навпаки, забороняє.

Призначення пар директив.

• %LIST і %NOLIST (.LIST і .XLIST)

Директиви .LIST чи %LIST визначають необхідність виведення у файл лістингу всіх рядків вихідного коду. Для заборони виведення у файл лістингу всіх рядків вихідного коду необхідно використовувати директиви .XLIST чи %NOLIST. У тексті програми їх можна застосовувати довільну кількість разів, при цьому чергова директива скасовує дію попередньої.

• %CTLS і %NOCTLS

Якщо попередні директиви впливають на повноту представлення вихідного коду в цілому, то директиви %CTLS і %NOCTLS керують виведенням у файл лістингу самих директив керування лістингом.

• %SYMS і %NOSYMS Ці директиви визначають, включати (%SYMS) чи не включати (%NOSYMS) у файл лістингу таблицю ідентифікаторів. 

• Директиви виводу тексту файлів, що включаються

%INCL і %NOINCL

Ці директиви дозволяють регулювати включення у файл лістингу тексту файлів, що включаються, (по директиві INCLUDE). За замовчуванням файли, що включаються, записуються у файл лістингу. Директива %NOINCL забороняє виведення у файл лістингу всіх наступних файлів, що включаються, поки виведення знову не буде дозволений директивою %INCL.

• Директиви виведення блоків умовного асемблювання

%CONDS і %NOCONDS (.LFCOND і .SFCONDS)

Для дослідження вихідного тексту програми, що містять директиви умовної компіляції, зручно використовувати директиви, що регулюють включення блоків умовної компіляції в лістинг програми. Директива %CONDS (.LFCOND) змушує TASM виводити у файл лістингу всі оператори умовних блоків. При цьому у файл лістингу виводяться всі блоки, у тому числі з умовою false. Директива %NOCONDS (.SFCONDS) забороняє виведення у файл лістингу блоків умовного асемблювання з умовою false. Директива .TFCOND переключає режими висновку %CONDS (.LFCOND) і %NOCONDS (.SFCONDS). Цю директиву можна використовувати як окремо, так і разом з директивами .LFCOND і .SFCONDS. Перша директива .TFCOND дозволяє виведення у лістинг усіх блоків умовного асемблювання. Наступна директива .TFCOND буде забороняти виведення цих блоків. З директивою .TFCOND можна використовувати параметр командного рядка транслятора TASM ? /X: відповідно до нього блоки умовного асемблювання будуть спочатку виводитися в лістинг, але перша ж директива .TFCOND заборонить їхній виведення.