リストのオン/オフ切り替え

エラーメッセージを除くすべてのリスト出力を無効にするには、LSTOUT-を使用します。このディレクティブは、他のどのリスト制御ディレクティブよりも優先されます。

デフォルトはLSTOUT+です。この場合、出力がリストされます(リストファイルが指定されていない場合)。

プログラム内のデバッグされた部分のリストを無効にするには、以下のように指定します。

            lstout-
            ; This section has already been debugged.
            lstout+
            ; This section is currently being debugged.
            end

条件付きコードと文字列のリスト

前の条件付き文IFによって無効にされていないアセンブリ部分のみのために、アセンブラにソースコードを強制的にリストさせるには、LSTCND+を使用します。

デフォルト設定はLSTCND-であり、すべてのソース行がリストされます。

LSTCOD-を使用すると、出力コードのリストが、ソースコード1行につき最初の行だけに制限されます。

デフォルトの設定はLSTCOD+で、ソースコード1行につき必要があれば複数行のコードがリスト出力されます。つまり長いASCII文字列からは、複数行が出力されます。コードの生成には影響はありません。

以下の例は、IFディレクティブによって無効にされたサブルーチンの呼び出しを、LSTCND+がどのように非表示にするのかを示します。

            name    lstcndTest
            extern  print
            section FLASH:CODE(2)

debug       set     0
            if      debug
            bl      print
            endif

            lstcnd+
begin2      if      debug
            bl      print
            endif

            end

これにより、以下のリストが生成されます。

    9                          name    lstcndTest
   10                          extern  print
   11                          section FLASH:CODE(2)
   12
   13     debug                set     0
   14     begin                if      debug
   15                          bl      print
   16                          endif
   17
   18                          lstcnd+
   19     begin2               if      debug
   21                          endif
   22
   23                          end

マクロのリストの制御

マクロで生成された行のリストを無効にするには、LSTEXP-を使用します。デフォルトはLSTEXP+であり、マクロで生成されたすべての行がリストされます。

マクロ定義をリストするには、LSTMAC+を使用します。デフォルトはLSTMAC-であり、マクロ定義のリストが無効になります。

以下の例は、LSTMACとLSTEXPの効果を示します。

            name    lstmacTest
            extern  memLoc
            section FLASH:CODE(2)

dec2        macro   arg
            subs    r1,r1,#arg
            subs    r1,r1,#arg
            endm

            lstmac+
inc2        macro   arg
            adds    r1,r1,#arg
            adds    r1,r1,#arg
            endm

begin       dec2    memLoc
            lstexp-
            inc2    memLoc
            bx      lr

; Restore default values for
; listing control directives.

            lstmac-
            lstexp+

            end

以下のテキストが表示されます。

   13                          name    lstmacTest
   14                          extern  memLoc
   15                          section FLASH:CODE(2)
   16
   21
   22                          lstmac+
   23              inc2        macro   arg
   24                          adds    r1,r1,#arg
   25                          adds    r1,r1,#arg
   26                          endm
   27
   28              begin       dec2    memLoc
   28.1  00000000 ........     subs    r1,r1,#memLoc
   28.2  00000004 ........     subs    r1,r1,#memLoc
   28.3                        endm
   29                          lstexp-
   30                          inc2    memLoc
   31    00000010 1EFF2FE1     bx      lr
   32
   33              ; Restore default values for
   34              ; listing control directives.
   35
   36                          lstmac-
   37                          lstexp+
   38
   39                          end

生成された行のリストを制御します

ディレクティブREPT、REPTC、REPTIによって生成された行のリストをオフにするにはLSTREP-を使用します。

デフォルトはLSTREP+であり、生成された行がリストされます。

クロスリファレンステーブルの生成

現在のモジュールのアセンブラリストの最後にクロスリファレンステーブルを生成するには、LSTXRF+を使用します。このテーブルは、値と行番号、およびシンボルの型を示します。

デフォルトはLSTXRF-であり、クロスリファレンステーブルは生成されません。

リストファイル出力形式の指定

アセンブラリストのページあたりのカラム数を設定するにはCOLを使用します。デフォルトのカラム数は80です。

アセンブラリストのページあたりの行数を設定するにはPAGSIZを使用します。デフォルトの行数は44です。

アセンブラ出力リストをページ単位でフォーマットするにLSTPAG+を使用します。

デフォルトはLSTPAG-で、連続したリストが出力されます。

ページ作成が有効なとき、アセンブラリスト中に新しいページを生成するにはPAGEを使用します。