ユニットテストの修正
[YACASL2.git] / doc / yacasl2.html
1 <html lang="en">
2 <head>
3 <title>YACASL2 - Linux上のCASL II処理系</title>
4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
5 <meta name="description" content="YACASL2 - Linux上のCASL II処理系">
6 <meta name="generator" content="makeinfo 4.11">
7 <link title="Top" rel="top" href="#Top">
8 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
9 <!--
10 Copyright (C) 2010 j8takagi-->
11 <meta http-equiv="Content-Style-Type" content="text/css">
12 <style type="text/css"><!--
13   pre.display { font-family:inherit }
14   pre.format  { font-family:inherit }
15   pre.smalldisplay { font-family:inherit; font-size:smaller }
16   pre.smallformat  { font-family:inherit; font-size:smaller }
17   pre.smallexample { font-size:smaller }
18   pre.smalllisp    { font-size:smaller }
19   span.sc    { font-variant:small-caps }
20   span.roman { font-family:serif; font-weight:normal; } 
21   span.sansserif { font-family:sans-serif; font-weight:normal; } 
22 body {
23     margin-left: 6em;
24     margin-right: 12em;
25     color: black;
26     background-color: #EEE;
27 }
28
29 h1, h2 {
30     margin-left: -2em;
31 }
32
33 .node{
34     margin-left: -3em;
35 }
36
37 h2 {
38     padding: 0.25em;
39     color: white;
40     background-color: navy;
41 }
42
43 h3, h4 {
44     color: navy;
45     margin-left: -1em;
46 }
47
48 p {
49     line-height: 1.5em;
50     margin-top: 0;
51     margin-bottom: 0.5em;
52 }
53
54 a:hover {
55     color: red;
56     text-decoration: underline;
57 }
58
59 .command {
60     font-family: monospace;
61 }
62
63 table.cartouche {
64     width: 60%;
65 }
66
67 pre.example {
68     padding: 0.5em 1em 0.5em 1em;
69     color: #CCC;
70     background: black;
71     font-size: 90%;
72 }
73
74 a {
75     text-decoration: none;
76 }
77
78 blockquote.p {
79     margin-top:0;
80     padding-top:0;
81     line-height: 100%;
82 }
83
84 table, th, td {
85     border: 1px solid #CCC;
86     border-collapse: collapse; /* 枠線の表示方法 */
87 }
88
89 table.cartouche, table.cartouche th, table.cartouche td  {
90     border: none;
91 }
92
93 pre.example .command, pre.example .option {
94     font-weight: bold;
95     background-color: inherit;
96     color: white;
97 }
98
99 pre.example strong {
100     font: inherit;
101     border: 2px solid green;
102 }
103 --></style>
104 </head>
105 <body>
106 <h1 class="settitle">YACASL2 - Linux上のCASL II処理系</h1>
107 <a name="Top"></a>
108
109 <div class="contents">
110 <h2>Table of Contents</h2>
111 <ul>
112 <li><a name="toc_YACASL2_00e3_0081_00ae_00e6_00a6_0082_00e8_00a6_0081" href="#YACASL2_00e3_0081_00ae_00e6_00a6_0082_00e8_00a6_0081">1 YACASL2の概要</a>
113 <ul>
114 <li><a href="#YACASL2_00e3_0081_00ae_00e6_00a6_0082_00e8_00a6_0081">要件</a>
115 </li></ul>
116 <li><a name="toc_YACASL2_00e3_0081_00ae_00e3_0082_00a4_00e3_0083_00b3_00e3_0082_00b9_00e3_0083_0088_00e3_0083_00bc_00e3_0083_00ab" href="#YACASL2_00e3_0081_00ae_00e3_0082_00a4_00e3_0083_00b3_00e3_0082_00b9_00e3_0083_0088_00e3_0083_00bc_00e3_0083_00ab">2 YACASL2のインストール</a>
117 <ul>
118 <li><a href="#YACASL2_00e3_0081_00ae_00e3_0082_00a4_00e3_0083_00b3_00e3_0082_00b9_00e3_0083_0088_00e3_0083_00bc_00e3_0083_00ab">2.1 YACASL2ファイルのダウンロード</a>
119 <li><a href="#YACASL2_00e3_0081_00ae_00e3_0082_00a4_00e3_0083_00b3_00e3_0082_00b9_00e3_0083_0088_00e3_0083_00bc_00e3_0083_00ab">2.2 YACASL2ファイルの検証</a>
120 <li><a href="#YACASL2_00e3_0081_00ae_00e3_0082_00a4_00e3_0083_00b3_00e3_0082_00b9_00e3_0083_0088_00e3_0083_00bc_00e3_0083_00ab">2.3 YACASL2ファイルの展開</a>
121 <li><a href="#YACASL2_00e3_0081_00ae_00e3_0082_00a4_00e3_0083_00b3_00e3_0082_00b9_00e3_0083_0088_00e3_0083_00bc_00e3_0083_00ab">2.4 <samp><span class="command">casl2</span></samp>、<samp><span class="command">comet2</span></samp>、<samp><span class="command">dumpword</span></samp>のビルド</a>
122 <li><a href="#YACASL2_00e3_0081_00ae_00e3_0082_00a4_00e3_0083_00b3_00e3_0082_00b9_00e3_0083_0088_00e3_0083_00bc_00e3_0083_00ab">2.5 <samp><span class="command">casl2</span></samp>の実行テスト</a>
123 <li><a href="#YACASL2_00e3_0081_00ae_00e3_0082_00a4_00e3_0083_00b3_00e3_0082_00b9_00e3_0083_0088_00e3_0083_00bc_00e3_0083_00ab">2.6 詳細なテスト</a>
124 <li><a href="#YACASL2_00e3_0081_00ae_00e3_0082_00a4_00e3_0083_00b3_00e3_0082_00b9_00e3_0083_0088_00e3_0083_00bc_00e3_0083_00ab">2.7 環境変数<var>PATH</var>の設定</a>
125 </li></ul>
126 <li><a name="toc_YACASL2_00e3_0081_00ae_00e4_00bd_00bf_00e3_0081_0084_00e6_0096_00b9" href="#YACASL2_00e3_0081_00ae_00e4_00bd_00bf_00e3_0081_0084_00e6_0096_00b9">3 YACASL2 の使い方</a>
127 <ul>
128 <li><a href="#YACASL2_00e3_0081_00ae_00e4_00bd_00bf_00e3_0081_0084_00e6_0096_00b9">3.1 実行結果の出力だけを表示</a>
129 <li><a href="#YACASL2_00e3_0081_00ae_00e4_00bd_00bf_00e3_0081_0084_00e6_0096_00b9">3.2 アセンブル結果の確認</a>
130 <li><a href="#YACASL2_00e3_0081_00ae_00e4_00bd_00bf_00e3_0081_0084_00e6_0096_00b9">3.3 実行時のレジスタとメモリを表示</a>
131 <ul>
132 <li><a href="#YACASL2_00e3_0081_00ae_00e4_00bd_00bf_00e3_0081_0084_00e6_0096_00b9">3.3.1 特定のレジスタを表示</a>
133 <li><a href="#YACASL2_00e3_0081_00ae_00e4_00bd_00bf_00e3_0081_0084_00e6_0096_00b9">3.3.2 プログラム終了時の値を表示</a>
134 <li><a href="#YACASL2_00e3_0081_00ae_00e4_00bd_00bf_00e3_0081_0084_00e6_0096_00b9">3.3.3 プログラムのステップ数を表示</a>
135 </li></ul>
136 <li><a href="#YACASL2_00e3_0081_00ae_00e4_00bd_00bf_00e3_0081_0084_00e6_0096_00b9">3.4 アセンブルと実行を別に行う</a>
137 <li><a href="#YACASL2_00e3_0081_00ae_00e4_00bd_00bf_00e3_0081_0084_00e6_0096_00b9">3.5 1語の解析</a>
138 <li><a href="#YACASL2_00e3_0081_00ae_00e4_00bd_00bf_00e3_0081_0084_00e6_0096_00b9">3.6 CASL2ライブラリの使用</a>
139 <ul>
140 <li><a href="#YACASL2_00e3_0081_00ae_00e4_00bd_00bf_00e3_0081_0084_00e6_0096_00b9">3.6.1 数値を出力する</a>
141 </li></ul>
142 </li></ul>
143 <li><a name="toc_YACASL2_00e3_0082_00b3_00e3_0083_009e_00e3_0083_00b3_00e3_0083_0089_00e3_0083_009e_00e3_0083_008b_00e3_0083_00a5_00e3_0082_00a2_00e3_0083_00ab" href="#YACASL2_00e3_0082_00b3_00e3_0083_009e_00e3_0083_00b3_00e3_0083_0089_00e3_0083_009e_00e3_0083_008b_00e3_0083_00a5_00e3_0082_00a2_00e3_0083_00ab">4 YACASL2コマンドマニュアル</a>
144 <ul>
145 <li><a href="#casl2">4.1 <samp><span class="command">casl2</span></samp></a>
146 <ul>
147 <li><a href="#casl2">オプション</a>
148 </li></ul>
149 <li><a href="#comet2">4.2 <samp><span class="command">comet2</span></samp></a>
150 <ul>
151 <li><a href="#comet2">オプション</a>
152 </li></ul>
153 <li><a href="#dumpword">4.3 <samp><span class="command">dumpword</span></samp></a>
154 <ul>
155 <li><a href="#dumpword">オプション</a>
156 </li></ul>
157 </li></ul>
158 <li><a name="toc_CASL2LIB_00e3_0083_009e_00e3_0083_008b_00e3_0083_00a5_00e3_0082_00a2_00e3_0083_00ab" href="#CASL2LIB_00e3_0083_009e_00e3_0083_008b_00e3_0083_00a5_00e3_0082_00a2_00e3_0083_00ab">5 CASL2LIBマニュアル</a>
159 <ul>
160 <li><a href="#ABS">5.1 <samp><span class="command">ABS</span></samp> - <samp><span class="file">abs.casl</span></samp></a>
161 <ul>
162 <li><a href="#ABS">入力</a>
163 <li><a href="#ABS">出力</a>
164 <li><a href="#ABS">依存する副プログラム</a>
165 <li><a href="#ABS">使用例</a>
166 </li></ul>
167 <li><a href="#ADDL32">5.2 <samp><span class="command">ADDL32</span></samp> - <samp><span class="file">addl32.casl</span></samp></a>
168 <ul>
169 <li><a href="#ADDL32">入力</a>
170 <li><a href="#ADDL32">出力</a>
171 <li><a href="#ADDL32">使用例</a>
172 <li><a href="#ADDL32">依存する副プログラム</a>
173 </li></ul>
174 <li><a href="#DIVA">5.3 <samp><span class="command">DIVA</span></samp> -<samp><span class="file">diva.casl</span></samp></a>
175 <ul>
176 <li><a href="#DIVA">入力</a>
177 <li><a href="#DIVA">出力</a>
178 <li><a href="#DIVA">依存する副プログラム</a>
179 </li></ul>
180 <li><a href="#DIVL">5.4 <samp><span class="command">DIVL</span></samp> - <samp><span class="file">divl.casl</span></samp></a>
181 <ul>
182 <li><a href="#DIVL">入力</a>
183 <li><a href="#DIVL">出力</a>
184 <li><a href="#DIVL">依存する副プログラム</a>
185 <li><a href="#DIVL">使用例</a>
186 </li></ul>
187 <li><a href="#INL">5.5 <samp><span class="command">INL</span></samp> - <samp><span class="file">inl.casl</span></samp></a>
188 <li><a href="#L2STR">5.6 <samp><span class="command">L2STR</span></samp> - <samp><span class="file">l2str.casl</span></samp></a>
189 <li><a href="#MAX">5.7 <samp><span class="command">MAX</span></samp> - <samp><span class="file">max.casl</span></samp></a>
190 <li><a href="#MINIM">5.8 <samp><span class="command">MINIM</span></samp> - <samp><span class="file">minim.casl</span></samp></a>
191 <li><a href="#MULA">5.9 <samp><span class="command">MULA</span></samp> - <samp><span class="file">mula.casl</span></samp></a>
192 <li><a href="#MULL">5.10 <samp><span class="command">MULL</span></samp> - <samp><span class="file">mull.casl</span></samp></a>
193 <li><a href="#OUTA">5.11 <samp><span class="command">OUTA</span></samp> - <samp><span class="file">outa.casl</span></samp></a>
194 <li><a href="#OUTB">5.12 <samp><span class="command">OUTB</span></samp> - <samp><span class="file">outb.casl</span></samp></a>
195 <li><a href="#OUTD_005fQ15">5.13 <samp><span class="command">OUTD_Q15</span></samp> - <samp><span class="file">outd_q15.casl</span></samp></a>
196 <li><a href="#OUTL">5.14 <samp><span class="command">OUTL</span></samp> - <samp><span class="file">outl.casl</span></samp></a>
197 <li><a href="#REV">5.15 <samp><span class="command">REV</span></samp> - <samp><span class="file">rev.casl</span></samp></a>
198 <li><a href="#STR2L">5.16 <samp><span class="command">STR2L</span></samp> - <samp><span class="file">str2l.casl</span></samp></a>
199 </li></ul>
200 </li></ul>
201 </div>
202
203 <p><a name="YACASL2%e3%81%ae%e6%a6%82%e8%a6%81"></a>
204 <a name="YACASL2_00e3_0081_00ae_00e6_00a6_0082_00e8_00a6_0081"></a>
205
206 <h2 class="chapter">1 YACASL2の概要</h2>
207
208 <p>YACASL2は、Linux上で動作するオープンソースのCASL II処理系です。CASL IIは情報処理試験で用いられるアセンブラ言語で、次の資料により仕様が公開されています。
209
210  <blockquote>
211 <a href="http://www.jitec.ipa.go.jp/1_00topic/topic_20081027_hani_yougo.pdf">試験で使用する情報処理用語・プログラム言語など(2008年10月版)</a>[PDFファイル]
212 別紙 1 アセンブラ言語の仕様
213 </blockquote>
214
215  <p>YACASL2は、CASL IIアセンブラ言語で記述されたファイルをアセンブルし、仮想マシンCOMET II上で実行します。アセンブルと実行は、連続で行うことも別々に行うことも可能です。
216 YACASL2の動作はCASL IIの仕様に準拠しているため、情報処理試験の問題をはじめ各種参考書やサイトに記載されたCASL IIのプログラムをそのままアセンブルして実行できます。また、本パッケージ中にCASL IIのサンプルプログラムが多数収録されています。
217
218  <p>YACASL2は、「ふつうの処理系」として動作します。ほかの多くのCASL IIエミュレータと違い、デバッガとして動作したり、コンピュータ内部の模式図を表示したりすることはありません。そのかわり、YACASL2は、次のような動作内容をすべてテキストで出力します。
219
220      <ul>
221 <li>ラベルとアドレスの対応
222
223      <li>アセンブル結果
224
225      <li>実行時のレジスタの内容
226
227      <li>実行時のメモリの内容
228 </ul>
229
230  <p>出力された動作内容は、GNU/Linuxのさまざまなツール、たとえば<samp><span class="command">cat</span></samp>、<samp><span class="command">less</span></samp>、<samp><span class="command">grep</span></samp>、<samp><span class="command">wc</span></samp>などを使って解析できます。
231
232  <p>YACASL2の操作は、端末を開いてコマンドを入力・実行することで行います。
233
234 <h3 class="unnumberedsec">要件</h3>
235
236 <p>YACASL2は、Linux上で動作します。現在動作を確認しているのは、次のディストリビューションです。
237
238      <ul>
239 <li>Ubuntu Linux 9.04 / 8.04
240
241      <li>Vine Linux 4.2
242 </ul>
243
244  <p>インストール時に、<samp><span class="command">tar</span></samp>、<samp><span class="command">gcc</span></samp>、<samp><span class="command">make</span></samp>が必要です。
245
246 <p><a name="YACASL2%e3%81%ae%e3%82%a4%e3%83%b3%e3%82%b9%e3%83%88%e3%83%bc%e3%83%ab"></a>
247 <a name="YACASL2_00e3_0081_00ae_00e3_0082_00a4_00e3_0083_00b3_00e3_0082_00b9_00e3_0083_0088_00e3_0083_00bc_00e3_0083_00ab"></a>
248
249 <h2 class="chapter">2 YACASL2のインストール</h2>
250
251 <p>YACASL2をインストールするには、Linux上で次の作業をします。
252
253      <ol type=1 start=1>
254
255      <li>YACASL2ファイルのダウンロード
256
257      <li>YACASL2ファイルの検証
258
259      <li>YACASL2ファイルの展開
260
261      <li><samp><span class="command">casl2</span></samp>、<samp><span class="command">comet2</span></samp>、<samp><span class="command">dumpword</span></samp>のビルド
262
263      <li><samp><span class="command">casl2</span></samp>の実行テスト
264
265      <li>詳細なテスト
266
267      <li>環境変数<var>PATH</var>の設定
268       </ol>
269
270 <h3 class="section">2.1 YACASL2ファイルのダウンロード</h3>
271
272 <p><a href="http://github.com/j8takagi/YACASL2">GitHub/j8takagi/YACASL2</a>の<a href="http://github.com/j8takagi/YACASL2/downloads">ダウンロードページ</a>から最新版のtgzファイルをダウンロードします(2010年3月6日現在、<var>v0.1</var>の<samp><span class="file">j8takagi-YACASL2-6323ce4.tar.gz</span></samp>)。
273
274  <p>続けて、対応する<samp><span class="file">md5sum</span></samp>フィルをダウンロードします(2010年3月6日現在、<samp><span class="file">j8takagi-YACASL2-6323ce4.tar.gz.md5sum</span></samp>)。
275
276 <h3 class="section">2.2 YACASL2ファイルの検証</h3>
277
278 <p>ダウンロードが完了したら、<samp><span class="command">md5sum</span></samp>と<samp><span class="command">diff</span></samp>で正しくファイルがダウンロードができているかを検証します。
279
280 <pre class="example">  $ <samp><span class="command">md5sum yacasl2.tar.gz | diff -s yacasl2.tar.gz.md5sum -</span></samp>
281   Files yacasl2.tar.gz.md5sum and - are identical
282 </pre>
283  <h3 class="section">2.3 YACASL2ファイルの展開</h3>
284
285 <p>YACASL2ファイルをダウンロードしたら、次のコマンドで展開します。
286
287 <pre class="example">  $ <samp><span class="command">tar xvzf yacasl2.tar.gz</span></samp>
288 </pre>
289  <h3 class="section">2.4 <samp><span class="command">casl2</span></samp>、<samp><span class="command">comet2</span></samp>、<samp><span class="command">dumpword</span></samp>のビルド</h3>
290
291 <p>展開したら、次のコマンドで<samp><span class="command">casl2</span></samp>、<samp><span class="command">comet2</span></samp>、<samp><span class="command">dumpword</span></samp>をビルドします。
292
293 <pre class="example">  $ <samp><span class="command">cd yacasl2</span></samp>
294   $ <samp><span class="command">make</span></samp>
295   make -C src
296   make[1]: Entering directory ‘/home/kazubito/yacasl2/src’
297   gcc -c -g -Wall -I ../include casl2.c
298   gcc -c -g -Wall -I ../include word.c
299   gcc -c -g -Wall -I ../include hash.c
300   gcc -c -g -Wall -I ../include cerr.c
301   gcc -c -g -Wall -I ../include struct.c
302   gcc -c -g -Wall -I ../include cmd.c
303   gcc -c -g -Wall -I ../include assemble.c
304   gcc -c -g -Wall -I ../include token.c
305   gcc -c -g -Wall -I ../include label.c
306   gcc -c -g -Wall -I ../include macro.c
307   gcc -c -g -Wall -I ../include exec.c
308   gcc -c -g -Wall -I ../include dump.c
309   gcc -g -Wall -I ../include -o ../casl2 casl2.o word.o hash.o cerr.o st
310   ruct.o cmd.o assemble.o token.o label.o macro.o exec.o dump.o
311   gcc -c -g -Wall -I ../include comet2.c
312   gcc -g -Wall -I ../include -o ../comet2 comet2.o word.o hash.o cerr.o
313   struct.o cmd.o exec.o dump.o
314   gcc -c -g -Wall -I ../include dumpword.c
315   gcc -g -Wall -I ../include -o ../dumpword dumpword.o word.o cerr.o
316   make[1]: Leaving directory ‘/home/kazubito/yacasl2/src’
317 </pre>
318  <h3 class="section">2.5 <samp><span class="command">casl2</span></samp>の実行テスト</h3>
319
320 <p>ビルドしたら、次のコマンドが正常に実行できるかを確認します。
321 正常に実行された場合は、「Hello, World!」と表示されます。
322
323 <pre class="example">  $ <samp><span class="command">./casl2 as/hello.casl</span></samp>
324   Hello, World!
325 </pre>
326  <h3 class="section">2.6 詳細なテスト</h3>
327
328 <p>次のコマンドを実行すると、正常にビルドできているかどうかを詳細にテストできます。
329
330 <pre class="example">  $ <samp><span class="command">make check</span></samp>
331   194 / 194 tests passed. Details in /home/kazubito/yacasl2/test/integra
332   tion/casl2/Test.log
333   All tests are succeded.
334   149 / 149 tests passed. Details in /home/kazubito/yacasl2/test/integra
335   tion/comet2/Test.log
336   All tests are succeded.
337   4 / 4 tests passed. Details in /home/kazubito/yacasl2/test/integration
338   /dumpword/Test.log
339   All tests are succeded.
340 </pre>
341  <h3 class="section">2.7 環境変数<var>PATH</var>の設定</h3>
342
343 <p>環境変数<var>PATH</var>にYACASL2のディレクトリを追加すると、どのディレクトリでも<samp><span class="command">casl2</span></samp>、<samp><span class="command">comet2</span></samp>、<samp><span class="command">dumpword</span></samp>を実行できます。
344
345  <p>環境変数の設定方法は使っているシェルによって異なります。シェルは、次のコマンドで確認できます。
346
347 <pre class="example">  $ <samp><span class="command">echo $SHELL</span></samp>
348   /bin/bash
349 </pre>
350  <p>現在もっとも多く使われているシェルは、BASHでしょう。BASHでは、次のコマンドを実行すると環境変数<var>PATH</var>にYACASL2のディレクトリが追加されます。
351
352 <pre class="example">  $ <samp><span class="command">PATH=$PATH:~/yacasl2 &amp;&amp; export PATH</span></samp>
353 </pre>
354  <p>シェルの初期設定ファイルに上記のコマンドを追加すれば、今後ログインした後は自動的にどのディレクトリでも <samp><span class="command">casl2</span></samp>、<samp><span class="command">comet2</span></samp>、<samp><span class="command">dumpword</span></samp>を実行できます。BASHではホームディレクトリにある<samp><span class="file">.bashrc</span></samp>が初期設定ファイルのため、次のコマンドで追加されます。
355
356 <pre class="example">  $ <samp><span class="command">echo ’PATH=$PATH:~/yacasl2 &amp;&amp; export PATH’ &gt;&gt;~/.bashrc</span></samp>
357 </pre>
358  <p><a name="YACASL2%e3%81%ae%e4%bd%bf%e3%81%84%e6%96%b9"></a>
359 <a name="YACASL2_00e3_0081_00ae_00e4_00bd_00bf_00e3_0081_0084_00e6_0096_00b9"></a>
360
361 <h2 class="chapter">3 YACASL2 の使い方</h2>
362
363 <p>YACASL2 は、テキストファイルに記述されたCASLプログラムを処理します。以下の例で用いられるCASLプログラムのファイルは、テキストエディタなどで作成してください。また、インストールしたディレクトリの中にある<samp><span class="file">as</span></samp>ディレクトリからコピーして作成することもできます。
364
365 <h3 class="section">3.1 実行結果の出力だけを表示</h3>
366
367 <p>インストール時にコマンド実行の確認に使った<samp><span class="file">hello.casl</span></samp>は、次のような内容です。CASL IIのマクロ命令OUTは、文字列を出力します。
368
369 <pre class="example">  $ <samp><span class="command">cat hello.casl</span></samp>
370   MAIN     START
371            OUT     OBUF,LEN
372            RET
373   OBUF     DC      ’Hello, World!’
374   LEN      DC      13
375            END
376 </pre>
377  <p>次のコマンドを実行すると、CASL II のアセンブルと仮想マシン COMET II 上での実行が連続で行われ、文字列が出力されます。
378
379 <pre class="example">  $ <samp><span class="command">casl2 hello.casl</span></samp>
380   Hello, World!
381 </pre>
382  <p><samp><span class="file">addl.casl</span></samp>は、3と1の和を求めます。
383
384 <pre class="example">  $ <samp><span class="command">cat addl.casl</span></samp>
385   ;;; ADDL r,adr
386   MAIN     START
387            LD      GR1,A
388            ADDL    GR1,B
389            RET
390   A        DC      3
391   B        DC      1
392            END
393 </pre>
394  <p>このプログラムには出力命令がないため、オプションなしで実行した場合には結果が出力されません。
395
396 <pre class="example">  $ <samp><span class="command">casl2 addl.casl</span></samp>
397   $
398 </pre>
399  <p>実行内容を確認するには、後述のようにCPU 内にあるレジスタやメモリの内容を表示するか、結果を出力するための処理を追加する必要があります。
400
401  <p><samp><span class="file">sum_10.casl</span></samp>は、1から10までの整数の和を求めます。
402
403 <pre class="example">  $ <samp><span class="command">cat sum_10.casl</span></samp>
404   ;;; sum_10.casl
405   ;;; 出力 GR0: 1から10までの整数をすべて加算した値
406   MAIN    START
407           PUSH    0,GR1
408           LAD     GR0,0           ; GR0を初期化
409           LD      GR1,FST         ; GR1に初項を転送
410   LOOP    ADDL    GR0,GR1         ; ループ先頭
411           ADDL    GR1,STEP        ; GR1 &lt;- GR1 + 公差
412           CPL     GR1,LST         ; GR1が末項より大きい場合は終了
413           JPL     FIN             ; ↓
414           JUMP    LOOP            ; ループ終端
415   FIN     POP     GR1
416           RET
417   FST     DC      1               ; 初項
418   LST     DC      10              ; 末項
419   STEP    DC      1               ; 公差
420           END
421 </pre>
422  <p>このプログラムも、オプションなしで実行した場合には結果が出力されません。
423 <pre class="example">  $ <samp><span class="command">casl2 sum_10.casl</span></samp>
424   $
425 </pre>
426  <h3 class="section">3.2 アセンブル結果の確認</h3>
427
428 <p>casl2の処理途中で行われるアセンブルの結果を表示するには、オプション<samp><span class="option">-a</span></samp>を指定します。また、ラベルとアドレスの対応表を表示するには、オプション<samp><span class="option">-l</span></samp>を指定します。
429
430  <p>次のコマンドでは<samp><span class="file">hello.casl</span></samp>の、ラベルとアドレスの対応表と、アセンブル結果と、実行結果が表示されます。OUTはアセンブラ命令で複数の機械語命令で構成されているため、命令行1行に対して、複数行のコードが生成されます。
431
432 <pre class="example">  $ <samp><span class="command">casl2 -a -l hello.casl</span></samp>
433   
434   Assemble hello.casl (0)
435   
436   Label::::
437   MAIN.LEN ---&gt; #0020
438   MAIN ---&gt; #0000
439   MAIN.OBUF ---&gt; #0013
440   
441   Assemble hello.casl (1)
442   hello.casl:    1:MAIN    START
443   hello.casl:    2:        OUT     OBUF,LEN
444       #0000   #7001
445       #0001   #0000
446       #0002   #7002
447       #0003   #0000
448       #0004   #1210
449       #0005   #0013
450       #0006   #1220
451       #0007   #0020
452       #0008   #F000
453       #0009   #0002
454       #000A   #1210
455       #000B   #0021
456       #0021   #000A
457       #000C   #1220
458       #000D   #0022
459       #0022   #0001
460       #000E   #F000
461       #000F   #0002
462       #0010   #7120
463       #0011   #7110
464   hello.casl:    3:        RET
465       #0012   #8100
466   hello.casl:    4:OBUF    DC      'Hello, World!'
467       #0013   #0048
468       #0014   #0065
469       #0015   #006C
470       #0016   #006C
471       #0017   #006F
472       #0018   #002C
473       #0019   #0020
474       #001A   #0057
475       #001B   #006F
476       #001C   #0072
477       #001D   #006C
478       #001E   #0064
479       #001F   #0021
480   hello.casl:    5:LEN     DC      13
481       #0020   #000D
482   hello.casl:    6:        END
483   Hello, World!
484 </pre>
485  <p><samp><span class="file">addl.casl</span></samp>の、ラベルとアドレスの対応表と、アセンブル結果は、次のようになります。
486
487 <pre class="example">  $ <samp><span class="command">casl2 -a -l addl.casl</span></samp>
488   
489   Assemble addl.casl (0)
490   
491   Label::::
492   MAIN.A ---&gt; #0005
493   MAIN.B ---&gt; #0006
494   MAIN ---&gt; #0000
495   
496   Assemble addl.casl (1)
497   addl.casl:    1:;;; ADDL r,adr
498   addl.casl:    2:MAIN    START
499   addl.casl:    3:        LD      GR1,A
500       #0000   #1010
501       #0001   #0005
502   addl.casl:    4:        ADDL    GR1,B
503       #0002   #2210
504       #0003   #0006
505   addl.casl:    5:        RET
506       #0004   #8100
507   addl.casl:    6:A       DC      3
508       #0005   #0003
509   addl.casl:    7:B       DC      1
510       #0006   #0001
511   addl.casl:    8:        END
512 </pre>
513  <p>なお、オプション<samp><span class="option">-A</span></samp>を指定すると、アセンブル結果が表示される時点で処理が終了します。仮想マシンCOMET II での実行は行われません。
514
515 <h3 class="section">3.3 実行時のレジスタとメモリを表示</h3>
516
517 <p>YACASL2では実行中のCPUのレジスタとメモリの内容をそれぞれ、<samp><span class="option">-t</span></samp>と<samp><span class="option">-d</span></samp>を指定することで表示できます。
518
519  <p>また、<samp><span class="option">-M</span></samp>で、仮想マシンCOMET II のメモリ容量を語(16 ビット)単位で指定できます。小さいプログラムを実行するときは、メモリ容量を小さくすれば結果が見やすくなります。
520
521  <p><samp><span class="file">addl.casl</span></samp>に必要なメモリ容量は8語のため、次のようにCPUのレジスタとメモリの内容を表示できます。
522
523 <pre class="example">  $ <samp><span class="command">casl2 -t -d -M8 addl.casl | less</span></samp>
524   
525   Assemble addl.casl (0)
526   
527   Assemble addl.casl (1)
528   
529   Executing machine codes
530   #0000: Register::::
531   #0000: GR0:      0 = #0000 = 0000000000000000
532   #0000: GR1:      0 = #0000 = 0000000000000000
533   #0000: GR2:      0 = #0000 = 0000000000000000
534   #0000: GR3:      0 = #0000 = 0000000000000000
535   #0000: GR4:      0 = #0000 = 0000000000000000
536   #0000: GR5:      0 = #0000 = 0000000000000000
537   #0000: GR6:      0 = #0000 = 0000000000000000
538   #0000: GR7:      0 = #0000 = 0000000000000000
539   #0000: SP:       8 = #0008 = 0000000000001000
540   #0000: PR:       0 = #0000 = 0000000000000000
541   #0000: FR (OF SF ZF): 000
542   #0000: Memory::::
543   #0000: adr : 0000 0001 0002 0003 0004 0005 0006 0007
544   #0000: 0000: 1010 0005 2210 0006 8100 0003 0001 0000
545   #0002: Register::::
546   #0002: GR0:      0 = #0000 = 0000000000000000
547   #0002: GR1:      3 = #0003 = 0000000000000011
548   #0002: GR2:      0 = #0000 = 0000000000000000
549   #0002: GR3:      0 = #0000 = 0000000000000000
550   #0002: GR4:      0 = #0000 = 0000000000000000
551   #0002: GR5:      0 = #0000 = 0000000000000000
552   #0002: GR6:      0 = #0000 = 0000000000000000
553   #0002: GR7:      0 = #0000 = 0000000000000000
554   #0002: SP:       8 = #0008 = 0000000000001000
555   #0002: PR:       2 = #0002 = 0000000000000010
556   #0002: FR (OF SF ZF): 000
557   #0002: Memory::::
558   #0002: adr : 0000 0001 0002 0003 0004 0005 0006 0007
559   #0002: 0000: 1010 0005 2210 0006 8100 0003 0001 0000
560   #0004: Register::::
561   #0004: GR0:      0 = #0000 = 0000000000000000
562   #0004: GR1:      4 = #0004 = 0000000000000100
563   #0004: GR2:      0 = #0000 = 0000000000000000
564   #0004: GR3:      0 = #0000 = 0000000000000000
565   #0004: GR4:      0 = #0000 = 0000000000000000
566   #0004: GR5:      0 = #0000 = 0000000000000000
567   #0004: GR6:      0 = #0000 = 0000000000000000
568   #0004: GR7:      0 = #0000 = 0000000000000000
569   #0004: SP:       8 = #0008 = 0000000000001000
570   #0004: PR:       4 = #0004 = 0000000000000100
571   #0004: FR (OF SF ZF): 000
572   #0004: Memory::::
573   #0004: adr : 0000 0001 0002 0003 0004 0005 0006 0007
574   #0004: 0000: 1010 0005 2210 0006 8100 0003 0001 0000
575 </pre>
576  <h4 class="subsection">3.3.1 特定のレジスタを表示</h4>
577
578 <p><samp><span class="file">addl.casl</span></samp>のレジスタやメモリの中で、実行中に値が変化しているのはGR1だけです。こうした場合は、<samp><span class="command">grep</span></samp>を使って表示される内容を絞り込むことで動作を検証しやすくなります。
579
580 <pre class="example">  $ <samp><span class="command">casl2 -t addl.casl | grep 'GR1:'</span></samp>
581   #0000: GR1:      0 = #0000 = 0000000000000000
582   #0002: GR1:      3 = #0003 = 0000000000000011
583   #0004: GR1:      4 = #0004 = 0000000000000100
584 </pre>
585  <p>この内容を、先に出力したアセンブル結果と引き比べてください。
586 次の表のように、PRとGR1、命令行が対応していることがわかります。
587
588  <p><table summary=""><tr align="left"><td valign="top" width="30%">PR </td><td valign="top" width="30%">GR1 </td><td valign="top" width="40%">命令行
589 <br></td></tr><tr align="left"><td valign="top" width="30%">#0000
590 </td><td valign="top" width="30%">#0000
591 <br></td></tr><tr align="left"><td valign="top" width="30%">#0002
592 </td><td valign="top" width="30%">#0003
593 </td><td valign="top" width="40%"><code>LD GR1,A</code>
594 <br></td></tr><tr align="left"><td valign="top" width="30%">#0004
595 </td><td valign="top" width="30%">#0004
596 </td><td valign="top" width="40%"><code>ADDL GR1,B</code>
597  <br></td></tr></table>
598
599 <h4 class="subsection">3.3.2 プログラム終了時の値を表示</h4>
600
601 <p><samp><span class="command">grep</span></samp>と<samp><span class="command">tail</span></samp>を組み合わせれば、プログラム終了時の値を表示できます。
602
603 <pre class="example">  $ <samp><span class="command">casl2 -t addl.casl | grep 'GR1:' | tail -1</span></samp>
604   #0004: GR1:      4 = #0004 = 0000000000000100
605 </pre>
606  <pre class="example">  $ <samp><span class="command">casl2 -t sum_10.casl | grep 'GR0:' | tail -1</span></samp>
607   #0010: GR0:     55 = #0037 = 0000000000110111 = '7'
608 </pre>
609  <h4 class="subsection">3.3.3 プログラムのステップ数を表示</h4>
610
611 <p><samp><span class="command">grep</span></samp>と<samp><span class="command">wc</span></samp>を組み合わせれば、プログラムのステップ数を表示できます。
612
613 <pre class="example">  $ <samp><span class="command">casl2 -t hello.casl | grep 'GR1:' | wc -l</span></samp>
614   11
615 </pre>
616  <pre class="example">  $ <samp><span class="command">casl2 -t addl.casl | grep 'GR1:' | wc -l</span></samp>
617   3
618 </pre>
619  <p><samp><span class="file">sum_10.casl</span></samp>はプログラム内にループがあるため、ステップ数が大きくなります。
620
621 <pre class="example">  $ <samp><span class="command">casl2 -t sum_10.casl | grep 'GR0:' | wc -l</span></samp>
622   54
623 </pre>
624  <h3 class="section">3.4 アセンブルと実行を別に行う</h3>
625
626 <p><samp><span class="command">casl2</span></samp>に<samp><span class="option">-O</span></samp><samp><span class="file">ファイル名</span></samp>を指定すると、オブジェクトファイルを作成できます。
627
628 <pre class="example">  $ <samp><span class="command">casl2 -Ohello.o hello.casl</span></samp>
629 </pre>
630  <p>作成されたオブジェクトファイルの内容は、<samp><span class="command">od</span></samp>を使って確認できます。テキストファイルではないため、<samp><span class="command">cat</span></samp>などでは確認できません。
631
632 <pre class="example">  $ <samp><span class="command">od -t x2 hello.o</span></samp>
633   0000000 7001 0000 7002 0000 1210 0013 1220 0020
634   0000020 f000 0002 1210 0021 1220 0022 f000 0002
635   0000040 7120 7110 8100 0048 0065 006c 006c 006f
636   0000060 002c 0020 0057 006f 0072 006c 0064 0021
637   0000100 000d 000a 0001
638   0000106
639 </pre>
640  <p>オブジェクトファイルの実行には、<samp><span class="command">comet2</span></samp>を使います。
641
642 <pre class="example">  $ <samp><span class="command">comet2 hello.o</span></samp>
643   Hello, World!
644 </pre>
645  <h3 class="section">3.5 1語の解析</h3>
646
647 <p>CASL IIでは、1語(16ビット)を単位としてデータが処理されます。
648 <samp><span class="command">dumpword</span></samp>は、指定した1語を10進数、16進数、2進数で表示します。
649
650 <pre class="example">  $ <samp><span class="command">dumpword 72</span></samp>
651       72:     72 = #0048 = 0000000001001000 = 'H'
652 </pre>
653  <p>マイナスの数は、次のように指定します。
654
655 <pre class="example">  $ <samp><span class="command">dumpword -- -72</span></samp>
656      -72:    -72 = #FFB8 = 1111111110111000
657 </pre>
658  <p>16進数は、次のように指定します。
659
660 <pre class="example">  $ <samp><span class="command">dumpword '#0048'</span></samp>
661    #0048:     72 = #0048 = 0000000001001000 = 'H'
662 </pre>
663  <h3 class="section">3.6 CASL2ライブラリの使用</h3>
664
665 <p>YACASL2の<samp><span class="file">as/casl2lib</span></samp>ディレクトリには、CASL IIで記述されたライブラリファイルが格納されています。
666
667  <p>このフォルダには、たとえば次のようなプログラムが含まれています。
668
669      <dl>
670 <dt><samp><span class="option">OUTL</span></samp><dd><samp><span class="file">outl.casl</span></samp>。GR1に格納された値を、0〜65535の数値として出力します。
671
672      <br><dt><samp><span class="option">OUTA</span></samp><dd><samp><span class="file">outa.casl</span></samp>。GR1に格納された値を、-32767〜32767の数値として出力します。
673
674      <br><dt><samp><span class="option">MULL</span></samp><dd><samp><span class="file">mull.casl</span></samp>。GR1とGR2に格納された値を0〜65535の整数と見なし、積をGR3に格納します。
675
676      <br><dt><samp><span class="option">DIVL</span></samp><dd><samp><span class="file">divl.casl</span></samp>。GR1とGR2に格納された値を0〜65535の整数と見なし、商をGR3、剰余をGR0に格納します。
677 </dl>
678
679 <h4 class="subsection">3.6.1 数値を出力する</h4>
680
681 <p>3と1の和を求める<samp><span class="file">addl.casl</span></samp>で演算結果を出力するには、まず<samp><span class="file">addl.casl</span></samp>を編集します。CASL IIの<samp><span class="command">CALL</span></samp>命令で<samp><span class="command">OUTL</span></samp>を副プログラムとして呼び出すようにします。
682
683 <pre class="example">  $ <samp><span class="command">cat addl_outl.casl</span></samp>
684   MAIN    START
685           LD      GR1,A
686           ADDL    GR1,B
687           <strong>CALL    OUTL</strong>
688           RET
689   A       DC      3
690   B       DC      1
691           END
692 </pre>
693  <p>変更したら<samp><span class="command">casl2</span></samp>を、複数のファイルを指定して実行します。
694
695 <pre class="example">  $ <samp><span class="command">casl2 addl_outl.casl ~/yacasl2/as/casl2lib/outl.casl</span></samp>
696   4
697 </pre>
698  <p><a name="YACASL2%e3%82%b3%e3%83%9e%e3%83%b3%e3%83%89%e3%83%9e%e3%83%8b%e3%83%a5%e3%82%a2%e3%83%ab"></a>
699 <a name="YACASL2_00e3_0082_00b3_00e3_0083_009e_00e3_0083_00b3_00e3_0083_0089_00e3_0083_009e_00e3_0083_008b_00e3_0083_00a5_00e3_0082_00a2_00e3_0083_00ab"></a>
700
701 <h2 class="chapter">4 YACASL2コマンドマニュアル</h2>
702
703 <p><a name="index-YACASL2_00e3_0082_00b3_00e3_0083_009e_00e3_0083_00b3_00e3_0083_0089_00e3_0083_009e_00e3_0083_008b_00e3_0083_00a5_00e3_0082_00a2_00e3_0083_00ab-1"></a>
704 YACASL2のコマンドとオプションについて解説します。
705
706 <p><a name="casl2"></a>
707
708 <h3 class="section">4.1 <samp><span class="command">casl2</span></samp></h3>
709
710 <p><a name="index-casl2-2"></a><a name="index-casl2-3"></a>
711 <samp><span class="command">casl2</span></samp>は、引数として指定されたCASLファイルをアセンブルし、仮想マシンCOMET II上で実行します。CASLファイルは、アセンブラ言語CASL IIで記述されたテキストファイルです。引数が指定されない場合は、エラーメッセージを表示して終了します。
712
713 <pre class="example">  $ <samp><span class="command">casl2 hello.casl</span></samp>
714 </pre>
715  <p>副プログラムを呼び出す場合は、複数のCASLファイルを指定することもできます。
716
717 <pre class="example">  $ <samp><span class="command">casl2 addl_outl.casl ~/yacasl2/as/casl2lib/outl.casl</span></samp>
718 </pre>
719  <h4 class="unnumberedsubsec">オプション</h4>
720
721 <p><samp><span class="command">casl2</span></samp>は、次のオプションを指定できます。
722
723      <dl>
724 <dt><samp><span class="option">-s</span></samp><dt><samp><span class="option">--source</span></samp><dd>CASLファイルの内容を表示します。
725
726      <br><dt><samp><span class="option">-l</span></samp><dt><samp><span class="option">--label</span></samp><dd>ラベルの一覧を表示し、ほかの作業を続行します。
727
728      <br><dt><samp><span class="option">-L</span></samp><dt><samp><span class="option">--labelonly</span></samp><dd>ラベルの一覧を表示して終了します。
729
730      <br><dt><samp><span class="option">-a</span></samp><dt><samp><span class="option">--assembledetail</span></samp><dd>アセンブル詳細結果を表示し、ほかの作業を続行します。
731
732      <br><dt><samp><span class="option">-A</span></samp><dt><samp><span class="option">--show-all</span></samp><dd>アセンブル詳細結果を表示して終了します。
733
734      <br><dt><samp><span class="option">-o&lt;OBJECTFILE&gt;</span></samp><dt><samp><span class="option">--assembleout</span></samp><dd>アセンブル結果をオブジェクトファイル<samp><span class="file">&lt;OBJECTFILE&gt;</span></samp>に出力し、ほかの作業を続行します。出力されたオブジェクトファイルは、<samp><span class="command">comet2</span></samp>で実行できます。オブジェクトファイルを指定しない場合、出力先は<samp><span class="file">a.o</span></samp>です。オブジェクトファイルは1つだけ指定できます。
735
736      <br><dt><samp><span class="option">-O&lt;OBJECTFILE&gt;</span></samp><dt><samp><span class="option">--assembleoutonly</span></samp><dd>アセンブル結果をオブジェクトファイル<samp><span class="file">&lt;OBJECTFILE&gt;</span></samp>に出力し、終了します。出力されたオブジェクトファイルは、<samp><span class="command">comet2</span></samp>で実行できます。オブジェクトファイルを指定しない場合、出力先は<samp><span class="file">a.o</span></samp>です。オブジェクトファイルは1つだけ指定できます。
737
738      <br><dt><samp><span class="option">-t</span></samp><dt><samp><span class="option">--trace</span></samp><dt><samp><span class="option">--tracearithmetic</span></samp><dd>実行時のレジスタをトレースします。レジスタには、GR0〜GR7という8個の汎用レジスタと、SP(スタックポインタ)、PR(プログラムレジスタ)、FR(フラグレジスタ)があります。レジストリの内容は、-32,768〜32,767の範囲の整数、#0000〜#FFFFの範囲の16進数、2進数で表示されます。文字の組に該当する場合は、「 = 」のうしろに文字が表示されます。-32768〜32767の範囲の整数を表示するので、算術演算の結果を確認する場合に使えます。
739
740      <br><dt><samp><span class="option">-T</span></samp><dt><samp><span class="option">--tracelogical</span></samp><dd><samp><span class="option">-t</span></samp>と同じく、実行時のレジスタをトレースします。<samp><span class="option">-t</span></samp>と異なり0〜65,535の範囲の整数を表示するので、論理演算の結果を確認する場合に使えます。
741
742      <br><dt><samp><span class="option">-d</span></samp><dt><samp><span class="option">--dump</span></samp><dd>メモリの内容をすべて表示します。
743
744      <br><dt><samp><span class="option">-M &lt;MEMORYSIZE&gt;</span></samp><dt><samp><span class="option">--memorysize &lt;MEMORYSIZE&gt;</span></samp><dd>アセンブルおよび実行時のメモリサイズ<samp><span class="option">&lt;MEMORYSIZE&gt;</span></samp>を0〜65,535の範囲で指定します。指定しない場合、メモリサイズは512です。
745
746      <br><dt><samp><span class="option">-C &lt;CLOCKS&gt;</span></samp><dt><samp><span class="option">--clocks &lt;CLOCKS&gt;</span></samp><dd>実行時のクロック周波数<samp><span class="option">&lt;CLOCKS&gt;</span></samp>を0より大きい整数で指定します。指定しない場合、クロック周波数は5000000です。
747
748      <br><dt><samp><span class="option">-h</span></samp><dt><samp><span class="option">--help</span></samp><dd><samp><span class="command">casl2</span></samp>の使用方法を表示して終了します。
749 </dl>
750
751 <p><a name="comet2"></a>
752
753 <h3 class="section">4.2 <samp><span class="command">comet2</span></samp></h3>
754
755 <p><a name="index-comet2-4"></a><a name="index-comet2-5"></a>
756 <samp><span class="command">comet2</span></samp>は、引数として指定されたオブジェクトファイルを仮想マシンCOMET II上で実行します。オブジェクトファイルは、<samp><span class="command">casl</span></samp>に<samp><span class="option">-o</span></samp>または<samp><span class="option">-O</span></samp>を指定して出力します。
757
758 <pre class="example">  $ <samp><span class="command">comet2 hello.o</span></samp>
759 </pre>
760  <p>引数で指定できるオブジェクトファイルは1つだけです。引数が指定されない場合は、エラーメッセージを表示して終了します。複数の引数を指定した場合、2番目以降の引数は無視されます。
761
762 <h4 class="unnumberedsubsec">オプション</h4>
763
764 <p><samp><span class="command">comet2</span></samp>は、次のオプションを指定できます。
765
766      <dl>
767 <dt><samp><span class="option">-t</span></samp><dt><samp><span class="option">--trace</span></samp><dt><samp><span class="option">--tracearithmetic</span></samp><dd>実行時のレジスタをトレースします。レジスタには、GR0〜GR7という8個の汎用レジスタと、SP(スタックポインタ)、PR(プログラムレジスタ)、FR(フラグレジスタ)があります。レジストリの内容は、-32,768〜32,767の範囲の整数、#0000〜#FFFFの範囲の16進数、2進数で表示されます。文字の組に該当する場合は、「 = 」のうしろに文字が表示されます。-32768〜32767の範囲の整数が表示されるので、算術演算の結果を確認する場合に使えます。
768
769      <br><dt><samp><span class="option">-T</span></samp><dt><samp><span class="option">--tracelogical</span></samp><dd><samp><span class="option">-t</span></samp>と同じく、実行時のレジスタをトレースします。<samp><span class="option">-t</span></samp>と異なり0〜65,535の範囲の整数を表示するので、論理演算の結果を確認する場合に使えます。
770
771      <br><dt><samp><span class="option">-d</span></samp><dt><samp><span class="option">--dump</span></samp><dd>メモリの内容をすべて表示します。
772
773      <br><dt><samp><span class="option">-M &lt;MEMORYSIZE&gt;</span></samp><dt><samp><span class="option">--memorysize &lt;MEMORYSIZE&gt;</span></samp><dd>実行時のメモリサイズ<samp><span class="option">&lt;MEMORYSIZE&gt;</span></samp>を0〜65,535の範囲で指定します。指定しない場合、メモリサイズは512です。
774
775      <br><dt><samp><span class="option">-C &lt;CLOCKS&gt;</span></samp><dt><samp><span class="option">--clocks &lt;CLOCKS&gt;</span></samp><dd>実行時のクロック周波数<samp><span class="option">&lt;CLOCKS&gt;</span></samp>を0より大きい整数で指定します。指定しない場合、クロック周波数は5,000,000です。
776
777      <br><dt><samp><span class="option">-h</span></samp><dt><samp><span class="option">--help</span></samp><dd><samp><span class="command">comet2</span></samp>の使用方法を表示して終了します。
778 </dl>
779
780 <p><a name="dumpword"></a>
781
782 <h3 class="section">4.3 <samp><span class="command">dumpword</span></samp></h3>
783
784 <p><a name="index-dumpword-6"></a><a name="index-dumpword-7"></a>
785 <samp><span class="command">dumpword</span></samp>は、引数として指定された数値を、整数、#0000〜#FFFFの範囲の16進数、2進数で表示します。文字の組に該当する場合は、「 = 」のうしろに文字が表示されます。引数は、10進数または先頭に「#」の付いた16進数で指定します。表示される整数は、オプションにより-32,768〜32,767または0〜65,535の範囲です。オプションなしの場合は、-32,768〜32,767です。
786
787 <pre class="example">  $ <samp><span class="command">dumpword 10</span></samp>
788 </pre>
789  <p>引数で指定できる1つだけです。引数が指定されない場合は、使い方を表示して終了します。複数の引数を指定した場合、2番目以降の引数は無視されます。
790
791 <h4 class="unnumberedsubsec">オプション</h4>
792
793 <p><samp><span class="command">dumpword</span></samp>は、次のオプションを指定できます。
794
795      <dl>
796 <dt><samp><span class="option">-a</span></samp><dt><samp><span class="option">--arithmetic</span></samp><dd>出力される整数の範囲を-32,768〜32,767にします。オプションなしの場合と同じです。
797
798      <br><dt><samp><span class="option">-l</span></samp><dt><samp><span class="option">--logical</span></samp><dd>出力される整数の範囲を0〜65,535にします。
799
800      <br><dt><samp><span class="option">-h</span></samp><dt><samp><span class="option">--help</span></samp><dd><samp><span class="command">dumpword</span></samp>の使用方法を表示して終了します。
801 </dl>
802
803 <p><a name="CASL2LIB%e3%83%9e%e3%83%8b%e3%83%a5%e3%82%a2%e3%83%ab"></a>
804 <a name="CASL2LIB_00e3_0083_009e_00e3_0083_008b_00e3_0083_00a5_00e3_0082_00a2_00e3_0083_00ab"></a>
805
806 <h2 class="chapter">5 CASL2LIBマニュアル</h2>
807
808 <p><a name="ABS"></a>
809
810 <h3 class="section">5.1 <samp><span class="command">ABS</span></samp> - <samp><span class="file">abs.casl</span></samp></h3>
811
812 <p>入力された整数を絶対値に変換して出力
813
814 <h4 class="unnumberedsubsec">入力</h4>
815
816      <dl>
817 <dt><var>GR1</var><dd>-32768〜32767の整数
818 </dl>
819
820 <h4 class="unnumberedsubsec">出力</h4>
821
822      <dl>
823 <dt><var>GR1</var><dd>入力された整数の絶対値
824
825      <br><dt><var>OF</var><dd>入力されたGR1が-32768の場合、1
826
827      <br><dt><var>SF</var><dd>入力されたGR1が負数(-32767〜-1)の場合、1
828 </dl>
829
830 <h4 class="unnumberedsubsec">依存する副プログラム</h4>
831
832 <p>なし
833
834 <h4 class="unnumberedsubsec">使用例</h4>
835
836 <pre class="example"><pre class="verbatim">  ;;; ABSを呼び出す
837   MAIN    START
838           LAD     GR2,0
839   MLOOP   CPA     GR2,MLEN
840           JZE     MFIN
841           LD      GR1,MVAL,GR2
842           CALL    OUTA
843           CALL    ABS
844           JOV     PUTOV
845           JMI     PUTM
846           OUT     PLUS,=1
847           JUMP    PUTD
848   PUTM    OUT     MINUS,=1
849           JUMP    PUTD
850   PUTOV   OUT     OV,=2
851   PUTD    CALL    OUTA
852           OUT     SEP,MLEN
853           LAD     GR2,1,GR2
854           JUMP    MLOOP
855   MFIN    RET
856   MVAL    DC      12,-12,1,-1,32767,-32767,0,-32768
857   MLEN    DC      8
858   SEP     DC      '--------'
859   PLUS    DC      '+'
860   MINUS   DC      '-'
861   OV      DC      'OV'
862           END
863 </pre></pre>
864 <pre class="example"><pre class="verbatim">  ../../../../casl2 abs.casl ../../../../as/casl2lib/outa.casl
865   12
866   +
867   12
868   --------
869   -12
870   -
871   12
872   --------
873   1
874   +
875   1
876   --------
877   -1
878   -
879   1
880   --------
881   32767
882   +
883   32767
884   --------
885   -32767
886   -
887   32767
888   --------
889   0
890   +
891   0
892   --------
893   -32768
894   OV
895   -32768
896   --------
897 </pre></pre>
898  <p><a name="ADDL32"></a>
899
900 <h3 class="section">5.2 <samp><span class="command">ADDL32</span></samp> - <samp><span class="file">addl32.casl</span></samp></h3>
901
902 <p>32ビットの値を、連続する2語の領域に格納
903
904 <h4 class="unnumberedsubsec">入力</h4>
905
906      <dl>
907 <dt><var>GR1</var><dd>32ビット値1の先頭アドレス
908
909      <br><dt><var>GR2</var><dd>32ビット値2の先頭アドレス
910 </dl>
911
912 <h4 class="unnumberedsubsec">出力</h4>
913
914      <dl>
915 <dt><var>GR0</var><dd>和の先頭アドレス
916
917      <br><dt><var>OF</var><dd>上位アドレスでオーバーフローした場合、1
918
919      <br><dt><var>SF</var><dd>和が負数(-32767〜-1)の場合、1
920
921      <br><dt><var>ZF</var><dd>和が0の場合、1
922 </dl>
923
924 <h4 class="unnumberedsubsec">使用例</h4>
925
926 <pre class="example"><pre class="verbatim">  MAIN    START
927           LAD     GR1,A
928           LAD     GR2,B
929           CALL    ADDL32
930           LD      GR2,GR0
931           LD      GR1,1,GR2
932           CALL    OUTL
933           LD      GR1,0,GR2
934           CALL    OUTL
935           RET
936   A       DC      6,10
937   B       DC      2,65530
938           END
939 </pre></pre>
940 <pre class="example">  4
941   9
942 </pre>
943  <h4 class="unnumberedsubsec">依存する副プログラム</h4>
944
945 <p>なし
946
947 <p><a name="DIVA"></a>
948
949 <h3 class="section">5.3 <samp><span class="command">DIVA</span></samp> -<samp><span class="file">diva.casl</span></samp></h3>
950
951 <p>-32,767〜32,767の範囲にある整数の割算(筆算方式)を行う
952
953 <h4 class="unnumberedsubsec">入力</h4>
954
955      <dl>
956 <dt><var>GR1</var><dd>被除数
957
958      <br><dt><var>GR2</var><dd>除数
959 </dl>
960
961 <h4 class="unnumberedsubsec">出力</h4>
962
963      <dl>
964 <dt><var>GR0</var><dd>商
965
966      <br><dt><var>GR3</var><dd>剰余
967
968      <br><dt><var>OF</var><dd>除数が0の場合、1
969
970      <br><dt><var>SF</var><dd>商が負数(-32767〜-1)の場合、1
971
972      <br><dt><var>ZF</var><dd>商が0の場合、1
973 </dl>
974
975 <h4 class="unnumberedsubsec">依存する副プログラム</h4>
976
977      <ul>
978 <li><samp><span class="command">DIVL</span></samp>
979 </ul>
980
981 <!-- @unnumberedsubsec 使用例 -->
982 <!-- @iftex -->
983 <!-- @cartouche -->
984 <!-- @end iftex -->
985 <!-- @example -->
986 <!-- @verbatiminclude ../as/casl2lib/test/diva/diva.casl -->
987 <!-- @end example -->
988 <!-- @iftex -->
989 <!-- @end cartouche -->
990 <!-- @end iftex -->
991 <!-- @iftex -->
992 <!-- @cartouche -->
993 <!-- @end iftex -->
994 <!-- @example -->
995 <!-- @verbatiminclude ../as/casl2lib/test/diva/0.txt -->
996 <!-- @end example -->
997 <!-- @iftex -->
998 <!-- @end cartouche -->
999 <!-- @end iftex -->
1000 <p><a name="DIVL"></a>
1001
1002 <h3 class="section">5.4 <samp><span class="command">DIVL</span></samp> - <samp><span class="file">divl.casl</span></samp></h3>
1003
1004 <p>0〜65,535の範囲にある整数の割算(筆算方式)を行う
1005
1006 <h4 class="unnumberedsubsec">入力</h4>
1007
1008      <dl>
1009 <dt><var>GR1</var><dd>被除数
1010
1011      <br><dt><var>GR2</var><dd>除数
1012 </dl>
1013
1014 <h4 class="unnumberedsubsec">出力</h4>
1015
1016      <dl>
1017 <dt><var>GR0</var><dd>商
1018
1019      <br><dt><var>GR3</var><dd>剰余
1020
1021      <br><dt><var>OF</var><dd>除数が0の場合、1
1022
1023      <br><dt><var>SF</var><dd>商が32,768〜65535の場合、1
1024
1025      <br><dt><var>ZF</var><dd>商が0の場合、1
1026 </dl>
1027
1028 <h4 class="unnumberedsubsec">依存する副プログラム</h4>
1029
1030 <p>なし
1031
1032 <h4 class="unnumberedsubsec">使用例</h4>
1033
1034 <pre class="example"><pre class="verbatim">  MAIN    START
1035   BEGIN   LAD     GR1,101
1036           LAD     GR2,10
1037           CALL    DIVL
1038           RET
1039           END
1040 </pre></pre>
1041 <p><a name="INL"></a>
1042
1043 <h3 class="section">5.5 <samp><span class="command">INL</span></samp> - <samp><span class="file">inl.casl</span></samp></h3>
1044
1045 <p><a name="L2STR"></a>
1046
1047 <h3 class="section">5.6 <samp><span class="command">L2STR</span></samp> - <samp><span class="file">l2str.casl</span></samp></h3>
1048
1049 <p><a name="MAX"></a>
1050
1051 <h3 class="section">5.7 <samp><span class="command">MAX</span></samp> - <samp><span class="file">max.casl</span></samp></h3>
1052
1053 <p><a name="MINIM"></a>
1054
1055 <h3 class="section">5.8 <samp><span class="command">MINIM</span></samp> - <samp><span class="file">minim.casl</span></samp></h3>
1056
1057 <p><a name="MULA"></a>
1058
1059 <h3 class="section">5.9 <samp><span class="command">MULA</span></samp> - <samp><span class="file">mula.casl</span></samp></h3>
1060
1061 <p><a name="MULL"></a>
1062
1063 <h3 class="section">5.10 <samp><span class="command">MULL</span></samp> - <samp><span class="file">mull.casl</span></samp></h3>
1064
1065 <p><a name="OUTA"></a>
1066
1067 <h3 class="section">5.11 <samp><span class="command">OUTA</span></samp> - <samp><span class="file">outa.casl</span></samp></h3>
1068
1069 <p><a name="OUTB"></a>
1070
1071 <h3 class="section">5.12 <samp><span class="command">OUTB</span></samp> - <samp><span class="file">outb.casl</span></samp></h3>
1072
1073 <p><a name="OUTD_Q15"></a>
1074 <a name="OUTD_005fQ15"></a>
1075
1076 <h3 class="section">5.13 <samp><span class="command">OUTD_Q15</span></samp> - <samp><span class="file">outd_q15.casl</span></samp></h3>
1077
1078 <p><a name="OUTL"></a>
1079
1080 <h3 class="section">5.14 <samp><span class="command">OUTL</span></samp> - <samp><span class="file">outl.casl</span></samp></h3>
1081
1082 <p><a name="REV"></a>
1083
1084 <h3 class="section">5.15 <samp><span class="command">REV</span></samp> - <samp><span class="file">rev.casl</span></samp></h3>
1085
1086 <p><a name="STR2L"></a>
1087
1088 <h3 class="section">5.16 <samp><span class="command">STR2L</span></samp> - <samp><span class="file">str2l.casl</span></samp></h3>
1089
1090 </body></html>
1091
1092 <!--
1093 \1f
1094 Local Variables:
1095 coding: utf-8
1096 End:
1097
1098 -->