root/doc/manual.html

/* [<][>][^][v][top][bottom][index][help] */ 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 2010-2023 j8takagi -->
<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>YACASL2 - CASL II 処理システム</title>

<meta name="description" content="YACASL2 - CASL II 処理システム">
<meta name="keywords" content="YACASL2 - CASL II 処理システム">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="#Top" rel="start" title="Top">
<link href="#SEC_Contents" rel="contents" title="Table of Contents">
<link href="dir.html#Top" rel="up" title="(dir)">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
body {
    margin-left: 6em;
    margin-right: 12em;
    color: black;
    background-color: #EEE;
    font-family: sans-serif;
}

h1, h2, h3, h4, h5, h6 {
    color: navy;
    background-color: inherit;
}

h1, h2 {
    margin-left: -2em;
}

.node{
    margin-left: -3em;
    color: inherit;
    background-color: #DDF;
}

.menu, .node {
    color: inherit;
    background-color: #DDF;
}

table.menu, table.menu th, table.menu td {
    border-style: none;
}

h2 {
    padding: 0.25em;
    border: 2px solid navy;
}

.contents {
    background-color: #DDF;
    border: 4px double #000;
    padding: 0.5em 1em 0.5em 1em;
}

.contents h2 {
    margin-left: 0;
    color: black;
    background-color: #DDF;
}

.contents li {
    list-style-type: none;
}

.shortcontents {
    background-color: #DDF;
    border: 4px double #000;
 }

.shortcontents h2{
    display: none;
}

h1.node-heading {
    display: none;
}

h2.contents-heading{
    display: none;
}

h2.shortcontents-heading{
    display: none;
}

.shortcontents a {
   margin-right: 1em;
}

h3, h4, h5 {
    margin-left: -1em;
}

h5 {
    font-size: 100%;
}

p {
    line-height: 1.25em;
    margin-top: 0;
    margin-bottom: 0.5em;
}

a:hover {
    color: red;
    text-decoration: underline;
}

pre.example, pre.verbatim {
    padding: 0.5em 1em 0.5em 1em;
    border: 1px solid #CCC;
}

a {
    text-decoration: none;
}

blockquote {
    line-height: 1.25em;
    border: 1px solid #00F;
}

kbd, code, .file, var {
    font-style: normal;
    font-weight: normal;
    font-family: monospace;
    font-size: 120%;
    margin-left:0.25em;
    margin-right: 0.25em;
}

table, th, td {
    border: 1px solid black;
    border-collapse: collapse; /* 枠線の表示方法 */
    margin-bottom: 1em;
}

table.cartouche, table.cartouche th, table.cartouche td  {
    border: none;
}

pre.example .command, pre.example .option, pre.example kbd {
    font-weight: bold;
    font-family: monospace;
    font-size: 110%;
    background-color: inherit;
    font-style: normal;
    margin-left:0;
    margin-right: 0;
}

pre.example strong {
    font: inherit;
    border: 2px solid green;
}

pre.example em {
    font-size: 100%;
    font-style: normal;
    font-weight: bold;
}

th {
    font-style: normal;
    font-weight: bold;
    font-family: sans-serif;
}

th {
    text-align: center;
}

dfn {
    font-style: normal;
}

.header, .menu {
    display: none;
}

em {
    font-style: normal;
    font-weight: bold;
}

-->
</style>


</head>

<body lang="ja_JP">
<h1 class="settitle" align="center">YACASL2 - CASL II 処理システム</h1>




<span id="Top"></span><div class="header">
<p>
Next: <a href="#Overview" accesskey="n" rel="next">Overview</a>, Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<h1 class="node-heading">Top</h1>

<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Overview" accesskey="1">Overview</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">YACASL2の概要
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Sample-usage" accesskey="2">Sample usage</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">YACASL2の使用例
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#casl2-invocation" accesskey="3">casl2 invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">casl2の呼び出し
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#comet2-invocation" accesskey="4">comet2 invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">comet2の呼び出し
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#dumpword-invocation" accesskey="5">dumpword invocation</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">dumpwordの呼び出し
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

</pre></th></tr><tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> &mdash; The Detailed Node Listing &mdash;

YACASL2の使用例

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Simple-output" accesskey="6">Simple output</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">実行結果の出力だけを表示
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Assemble-result" accesskey="7">Assemble result</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">アセンブル結果の確認
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Register-and-memory" accesskey="8">Register and memory</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">実行時のレジスタとメモリを表示
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Only-assemble" accesskey="9">Only assemble</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">アセンブルと実行を別に行う
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Analyze-word">Analyze word</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">1語の解析
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Use-CASL2LIB">Use CASL2LIB</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">CASL IIライブラリの使用
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

実行時のレジスタとメモリを表示

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Register-specify">Register specify</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">特定のレジスタを表示
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#End-value">End value</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Step-count">Step count</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">プログラムのステップ数を表示
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

</pre></th></tr></table>

<span id="SEC_Contents"></span>
<h2 class="contents-heading">Table of Contents</h2>

<div class="contents">
<ul class="no-bullet">
<li><a id="toc-YACASL2noGai-Yao-" href="#Overview">1 YACASL2の概要</a></li>
<li><a id="toc-YACASL2noShi-Yong-Li" href="#Sample-usage">2 YACASL2の使用例</a>
<ul class="no-bullet">
  <li><a id="toc-Shi-Xing-Jie-Guo-noChu-Li-dakewoBiao-Shi" href="#Simple-output">2.1 実行結果の出力だけを表示</a></li>
  <li><a id="toc-asenburuJie-Guo-noQue-Ren-" href="#Assemble-result">2.2 アセンブル結果の確認</a></li>
  <li><a id="toc-Shi-Xing-Shi-norezisutatomemoriwoBiao-Shi" href="#Register-and-memory">2.3 実行時のレジスタとメモリを表示</a>
  <ul class="no-bullet">
    <li><a id="toc-Te-Ding-norezisutawoBiao-Shi" href="#Register-specify">2.3.1 特定のレジスタを表示</a></li>
    <li><a id="toc-puroguramuZhong-Liao-Shi-noZhi-woBiao-Shi" href="#End-value">2.3.2 プログラム終了時の値を表示</a></li>
    <li><a id="toc-puroguramunosutetupuShu-woBiao-Shi" href="#Step-count">2.3.3 プログラムのステップ数を表示</a></li>
  </ul></li>
  <li><a id="toc-asenburutoShi-Xing-woBie-niXing-u" href="#Only-assemble">2.4 アセンブルと実行を別に行う</a></li>
  <li><a id="toc-1Yu-noJie-Xi-" href="#Analyze-word">2.5 1語の解析</a></li>
  <li><a id="toc-CASL-IIraiburarinoShi-Yong-" href="#Use-CASL2LIB">2.6 CASL IIライブラリの使用</a>
  <ul class="no-bullet">
    <li><a id="toc-Shu-Zhi-woChu-Li-suru" href="#Shu-Zhi-woChu-Li-suru">2.6.1 数値を出力する</a></li>
  </ul></li>
</ul></li>
<li><a id="toc-casl2noHu-biChu-si" href="#casl2-invocation">3 <code>casl2</code>の呼び出し</a>
<ul class="no-bullet">
  <li><a id="toc-opusiyon" href="#opusiyon">オプション</a></li>
</ul></li>
<li><a id="toc-comet2noHu-biChu-si" href="#comet2-invocation">4 <code>comet2</code>の呼び出し</a>
<ul class="no-bullet">
  <li><a id="toc-opusiyon-1" href="#opusiyon-1">オプション</a></li>
</ul></li>
<li><a id="toc-dumpwordnoHu-biChu-si" href="#dumpword-invocation">5 <code>dumpword</code>の呼び出し</a>
<ul class="no-bullet">
  <li><a id="toc-Zhu-Yi-" href="#Zhu-Yi-">注意</a></li>
  <li><a id="toc-opusiyon-2" href="#opusiyon-2">オプション</a></li>
</ul></li>

</ul>
</div>


<hr>
<span id="Overview"></span><div class="header">
<p>
Next: <a href="#Sample-usage" accesskey="n" rel="next">Sample usage</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<span id="YACASL2noGai-Yao-"></span><h2 class="chapter">1 YACASL2の概要</h2>

<p>YACASL2は、UNIXやLinuxのコマンドラインインターフェイスで
動作するオープンソースのCASL II処理システムです。
CASL IIは情報処理試験で用いられるアセンブラ言語で、
次の資料により仕様が公開されています。
</p>
<blockquote>
<p><a href="https://www.ipa.go.jp/shiken/syllabus/ps6vr7000000i9g3-att/shiken_yougo_ver4_3.pdf">情報処理技術者試験 情報処理安全確保支援士試験 試験で使用する情報技術に関する用語・プログラム言語など Ver 4.3</a>［PDFファイル］ <br>
別紙2 アセンブラ言語の仕様（5ページから12ページまで）
</p></blockquote>

<p>YACASL2は、CASL IIアセンブラ言語で記述されたファイルをアセンブルし、
仮想マシンCOMET II上で実行します。
アセンブルと実行は、連続で行うこともできますし、
アセンブル結果をファイルに保存してあとから実行することもできます。
YACASL2の動作はCASL IIの仕様に準拠しているため、情報処理試験の問題を
はじめ各種参考書やサイトに記載されたCASL IIのプログラムを
そのままアセンブルして実行できます。
また、本パッケージ中にCASL IIのサンプルプログラムが多数収録されています。
</p>
<p>YACASL2は、「ふつうの処理系」として動作します。
YACASL2の操作は、端末上のコマンドラインインターフェイス（CLI）で操作します。
YACASL2は、次のような動作内容をすべてテキストで出力します。
</p>
<ul>
<li> ラベルとアドレスの対応

</li><li> アセンブル結果

</li><li> 実行時のレジスタの内容

</li><li> 実行時のメモリの内容
</li></ul>

<p>YACASL2では、機械コードモニターを使い、動作中のCPUやメモリーを調べたりデバッグしたりすることもできます。
</p>
<p>また、出力された動作内容は、GNU/Linuxのさまざまなコマンド、
たとえば、<code>cat</code>、<code>less</code>、<code>grep</code>、<code>wc</code>などを使って解析できます。
</p>


<hr>
<span id="Sample-usage"></span><div class="header">
<p>
Next: <a href="#casl2-invocation" accesskey="n" rel="next">casl2 invocation</a>, Previous: <a href="#Overview" accesskey="p" rel="prev">Overview</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<span id="YACASL2noShi-Yong-Li"></span><h2 class="chapter">2 YACASL2の使用例</h2>
<p>YACASL2 は、テキストファイルに記述されたCASLプログラムを処理します。
以下の例で用いられるCASLプログラムのファイルは、
テキストエディタなどで作成するか、インストールしたディレクトリの
中にある<samp>as</samp>ディレクトリからコピーしてください。
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Simple-output" accesskey="1">Simple output</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">実行結果の出力だけを表示
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Assemble-result" accesskey="2">Assemble result</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">アセンブル結果の確認
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Register-and-memory" accesskey="3">Register and memory</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">実行時のレジスタとメモリを表示
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Only-assemble" accesskey="4">Only assemble</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">アセンブルと実行を別に行う
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Analyze-word" accesskey="5">Analyze word</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">1語の解析
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Use-CASL2LIB" accesskey="6">Use CASL2LIB</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">CASL IIライブラリの使用
</td></tr>
</table>

<hr>
<span id="Simple-output"></span><div class="header">
<p>
Next: <a href="#Assemble-result" accesskey="n" rel="next">Assemble result</a>, Previous: <a href="#Sample-usage" accesskey="p" rel="prev">Sample usage</a>, Up: <a href="#Sample-usage" accesskey="u" rel="up">Sample usage</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<span id="Shi-Xing-Jie-Guo-noChu-Li-dakewoBiao-Shi"></span><h3 class="section">2.1 実行結果の出力だけを表示</h3>

<p>インストール時にコマンド実行の確認に使った<samp>hello.casl</samp>は、次のような内容です。
CASL IIのマクロ命令OUTは、文字列を出力します。
</p>
<div class="example">
<pre class="example">$ <kbd>cat hello.casl</kbd>
MAIN     START
         OUT     OBUF,LEN
         RET
OBUF     DC      'Hello, World!'
LEN      DC      13
         END
</pre></div>

<p>次のコマンドを実行すると、CASL II のアセンブルと仮想マシン COMET II 上での実行が連続で行われ、文字列が出力されます。
</p>
<div class="example">
<pre class="example">$ <kbd>casl2 hello.casl</kbd>
Hello, World!
</pre></div>

<p><samp>addl.casl</samp>は、3と1の和を求めます。
</p>
<div class="example">
<pre class="example">$ <kbd>cat addl.casl</kbd>
;;; ADDL r,adr
MAIN     START
         LD      GR1,A
         ADDL    GR1,B
         RET
A        DC      3
B        DC      1
         END
</pre></div>

<p>このプログラムには出力命令がないため、オプションなしで実行した場合には結果が出力されません。
</p>
<div class="example">
<pre class="example">$ <kbd>casl2 addl.casl</kbd>
$
</pre></div>

<p>実行内容を確認するには、後述のようにCPU 内にあるレジスタやメモリの内容を表示するか、結果を出力するための処理を追加する必要があります。
</p>
<hr>
<span id="Assemble-result"></span><div class="header">
<p>
Next: <a href="#Register-and-memory" accesskey="n" rel="next">Register and memory</a>, Previous: <a href="#Simple-output" accesskey="p" rel="prev">Simple output</a>, Up: <a href="#Sample-usage" accesskey="u" rel="up">Sample usage</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<span id="asenburuJie-Guo-noQue-Ren-"></span><h3 class="section">2.2 アセンブル結果の確認</h3>

<p>casl2の処理途中で行われるアセンブルの結果を表示するには、オプション<samp>-a</samp>を指定します。
また、ラベルとアドレスの対応表を表示するには、オプション<samp>-l</samp>を指定します。
</p>
<p>次のコマンドでは<samp>hello.casl</samp>の、ラベルとアドレスの対応表と、アセンブル結果と、実行結果が表示されます。
OUTはアセンブラ命令で複数の機械語命令で構成されているため、命令行1行に対して、複数行のコードが生成されます。
</p>
<div class="example">
<pre class="example">$ <kbd>casl2 -a -l hello.casl</kbd>

Assemble hello.casl (0)

Label::::
MAIN.LEN ---&gt; #0020
MAIN ---&gt; #0000
MAIN.OBUF ---&gt; #0013

Assemble hello.casl (1)
hello.casl:    1:MAIN    START
hello.casl:    2:        OUT     OBUF,LEN
    #0000   #7001
    #0001   #0000
    #0002   #7002
    #0003   #0000
    #0004   #1210
    #0005   #0013
    #0006   #1220
    #0007   #0020
    #0008   #F000
    #0009   #0002
    #000A   #1210
    #000B   #0021
    #0021   #000A
    #000C   #1220
    #000D   #0022
    #0022   #0001
    #000E   #F000
    #000F   #0002
    #0010   #7120
    #0011   #7110
hello.casl:    3:        RET
    #0012   #8100
hello.casl:    4:OBUF    DC      'Hello, World!'
    #0013   #0048
    #0014   #0065
    #0015   #006C
    #0016   #006C
    #0017   #006F
    #0018   #002C
    #0019   #0020
    #001A   #0057
    #001B   #006F
    #001C   #0072
    #001D   #006C
    #001E   #0064
    #001F   #0021
hello.casl:    5:LEN     DC      13
    #0020   #000D
hello.casl:    6:        END
Hello, World!
</pre></div>

<p><samp>addl.casl</samp>の、ラベルとアドレスの対応表と、アセンブル結果は、次のようになります。
</p>
<div class="example">
<pre class="example">$ <kbd>casl2 -a -l addl.casl</kbd>

Assemble addl.casl (0)

Label::::
MAIN ---&gt; #0000
MAIN.A ---&gt; #0007
MAIN.B ---&gt; #0008
MAIN.C ---&gt; #0009

Assemble addl.casl (1)
addl.casl:    1:;;; ADDL r,adr
addl.casl:    2:MAIN    START
addl.casl:    3:        LD      GR1,A
    #0000   #1010
    #0001   #0007
addl.casl:    4:        ADDL    GR1,B
    #0002   #2210
    #0003   #0008
addl.casl:    5:        ST      GR1,C
    #0004   #1110
    #0005   #0009
addl.casl:    6:        RET
    #0006   #8100
addl.casl:    7:A       DC      3
    #0007   #0003
addl.casl:    8:B       DC      2
    #0008   #0002
addl.casl:    9:C       DS      1
    #0009   #0000
addl.casl:   10:        END
</pre></div>

<p>なお、オプション<samp>-A</samp>を指定すると、アセンブル結果が表示される時点で処理が終了します。
仮想マシンCOMET IIでのプログラム実行はされません。
</p>
<hr>
<span id="Register-and-memory"></span><div class="header">
<p>
Next: <a href="#Only-assemble" accesskey="n" rel="next">Only assemble</a>, Previous: <a href="#Assemble-result" accesskey="p" rel="prev">Assemble result</a>, Up: <a href="#Sample-usage" accesskey="u" rel="up">Sample usage</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<span id="Shi-Xing-Shi-norezisutatomemoriwoBiao-Shi"></span><h3 class="section">2.3 実行時のレジスタとメモリを表示</h3>

<p>YACASL2では実行中のCPUのレジスタとメモリの内容をそれぞれ、<samp>-t</samp>と<samp>-d</samp>を指定することで表示できます。
</p>
<p>また、<samp>-M</samp>で、仮想マシンCOMET II のメモリ容量を語(16 ビット)単位で指定できます。
小さいプログラムを実行するときは、メモリ容量を小さくすれば結果が見やすくなります。
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Register-specify" accesskey="1">Register specify</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">特定のレジスタを表示
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#End-value" accesskey="2">End value</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Step-count" accesskey="3">Step count</a></td><td>&nbsp;&nbsp;</td><td align="left" valign="top">プログラムのステップ数を表示
</td></tr>
</table>

<p><samp>addl.casl</samp>では、次のようにCPUのレジスタとメモリの内容を表示できます。
</p>
<div class="example">
<pre class="example">$ <kbd>casl2 -t -d -M16 addl.casl | less</kbd>

Assemble addl.casl (0)

Assemble addl.casl (1)

Executing machine codes
#0000: Register::::
#0000: GR0:      0 = #0000 = 0000000000000000
#0000: GR1:      0 = #0000 = 0000000000000000
#0000: GR2:      0 = #0000 = 0000000000000000
#0000: GR3:      0 = #0000 = 0000000000000000
#0000: GR4:      0 = #0000 = 0000000000000000
#0000: GR5:      0 = #0000 = 0000000000000000
#0000: GR6:      0 = #0000 = 0000000000000000
#0000: GR7:      0 = #0000 = 0000000000000000
#0000: SP:      16 = #0010 = 0000000000010000
#0000: PR:       0 = #0000 = 0000000000000000
#0000: FR (OF SF ZF): 000
#0000: Memory::::
#0000: adr : 0000 0001 0002 0003 0004 0005 0006 0007 0008 0009 000A 000B 000C 000D 000E 000F
       -------------------------------------------------------------------------------------
#0000: 0000: 1010 0007 2210 0008 1110 0009 8100 0003 0002 0000 0000 0000 0000 0000 0000 0000

#0002: Register::::
#0002: GR0:      0 = #0000 = 0000000000000000
#0002: GR1:      3 = #0003 = 0000000000000011
#0002: GR2:      0 = #0000 = 0000000000000000
#0002: GR3:      0 = #0000 = 0000000000000000
#0002: GR4:      0 = #0000 = 0000000000000000
#0002: GR5:      0 = #0000 = 0000000000000000
#0002: GR6:      0 = #0000 = 0000000000000000
#0002: GR7:      0 = #0000 = 0000000000000000
#0002: SP:      16 = #0010 = 0000000000010000
#0002: PR:       2 = #0002 = 0000000000000010
#0002: FR (OF SF ZF): 000
#0002: Memory::::
#0002: adr : 0000 0001 0002 0003 0004 0005 0006 0007 0008 0009 000A 000B 000C 000D 000E 000F
       -------------------------------------------------------------------------------------
#0002: 0000: 1010 0007 2210 0008 1110 0009 8100 0003 0002 0000 0000 0000 0000 0000 0000 0000

#0004: Register::::
#0004: GR0:      0 = #0000 = 0000000000000000
#0004: GR1:      5 = #0005 = 0000000000000101
#0004: GR2:      0 = #0000 = 0000000000000000
#0004: GR3:      0 = #0000 = 0000000000000000
#0004: GR4:      0 = #0000 = 0000000000000000
#0004: GR5:      0 = #0000 = 0000000000000000
#0004: GR6:      0 = #0000 = 0000000000000000
#0004: GR7:      0 = #0000 = 0000000000000000
#0004: SP:      16 = #0010 = 0000000000010000
#0004: PR:       4 = #0004 = 0000000000000100
#0004: FR (OF SF ZF): 000
#0004: Memory::::
#0004: adr : 0000 0001 0002 0003 0004 0005 0006 0007 0008 0009 000A 000B 000C 000D 000E 000F
       -------------------------------------------------------------------------------------
#0004: 0000: 1010 0007 2210 0008 1110 0009 8100 0003 0002 0000 0000 0000 0000 0000 0000 0000

#0006: Register::::
#0006: GR0:      0 = #0000 = 0000000000000000
#0006: GR1:      5 = #0005 = 0000000000000101
#0006: GR2:      0 = #0000 = 0000000000000000
#0006: GR3:      0 = #0000 = 0000000000000000
#0006: GR4:      0 = #0000 = 0000000000000000
#0006: GR5:      0 = #0000 = 0000000000000000
#0006: GR6:      0 = #0000 = 0000000000000000
#0006: GR7:      0 = #0000 = 0000000000000000
#0006: SP:      16 = #0010 = 0000000000010000
#0006: PR:       6 = #0006 = 0000000000000110
#0006: FR (OF SF ZF): 000
#0006: Memory::::
#0006: adr : 0000 0001 0002 0003 0004 0005 0006 0007 0008 0009 000A 000B 000C 000D 000E 000F
       -------------------------------------------------------------------------------------
#0006: 0000: 1010 0007 2210 0008 1110 0009 8100 0003 0002 0005 0000 0000 0000 0000 0000 0000
</pre></div>

<hr>
<span id="Register-specify"></span><div class="header">
<p>
Next: <a href="#End-value" accesskey="n" rel="next">End value</a>, Previous: <a href="#Register-and-memory" accesskey="p" rel="prev">Register and memory</a>, Up: <a href="#Register-and-memory" accesskey="u" rel="up">Register and memory</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<span id="Te-Ding-norezisutawoBiao-Shi"></span><h4 class="subsection">2.3.1 特定のレジスタを表示</h4>

<p><samp>addl.casl</samp>のレジスタやメモリの中で、実行中に値が変化しているのはGR1だけです。
こうした場合は、<code>grep</code>を使って表示される内容を絞り込むことで動作を検証しやすくなります。
</p>
<div class="example">
<pre class="example">$ <kbd>casl2 -t addl.casl | grep 'GR1:'</kbd>
#0000: GR1:      0 = #0000 = 0000000000000000
#0002: GR1:      3 = #0003 = 0000000000000011
#0004: GR1:      5 = #0005 = 0000000000000101
#0006: GR1:      5 = #0005 = 0000000000000101
</pre></div>

<p>この内容を、先に出力したアセンブル結果と比較してください。
次の表のように、PRとGR1、命令行が対応していることがわかります。
</p>
<table>
<tr><td width="30%">PR</td><td width="30%">GR1</td><td width="40%">命令行</td></tr>
<tr><td width="30%">#0000</td><td width="30%">#0000</td><td width="40%">（なし）</td></tr>
<tr><td width="30%">#0002</td><td width="30%">#0003</td><td width="40%"><code>LD GR1,A</code></td></tr>
<tr><td width="30%">#0004</td><td width="30%">#0004</td><td width="40%"><code>ADDL GR1,B</code></td></tr>
<tr><td width="30%">#0006</td><td width="30%">#0006</td><td width="40%"><code>ST GR1,C</code></td></tr>
</table>

<hr>
<span id="End-value"></span><div class="header">
<p>
Next: <a href="#Step-count" accesskey="n" rel="next">Step count</a>, Previous: <a href="#Register-specify" accesskey="p" rel="prev">Register specify</a>, Up: <a href="#Register-and-memory" accesskey="u" rel="up">Register and memory</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<span id="puroguramuZhong-Liao-Shi-noZhi-woBiao-Shi"></span><h4 class="subsection">2.3.2 プログラム終了時の値を表示</h4>

<p><code>grep</code>と<code>tail</code>を組み合わせれば、プログラム終了時の値を表示できます。
</p>
<p><samp>addl.casl</samp>でプログラム終了時のGR1の値を確認するには、次のようにします。
</p>
<div class="example">
<pre class="example">$ <kbd>casl2 -t addl.casl | grep 'GR1:' | tail -1</kbd>
#0006: GR1:      5 = #0005 = 0000000000000101
</pre></div>

<p><samp>sum_10.casl</samp>は、1から10までの整数の和を求め、GR2に格納してからメモリにストア（書き込み）します。
</p>
<div class="example">
<pre class="example">$ <kbd>cat sum_10.casl</kbd>
;;; sum_10.casl
;;; 1から10までの整数をすべて加算した値をメモリーに格納する
MAIN    START
        XOR     GR2,GR2         ; GR2を初期化
        LD      GR1,FST         ; GR1に初項をメモリーから転送
LOOP    ADDL    GR2,GR1         ; ループ先頭。GR2 &lt;- GR2 + GR1
        ADDL    GR1,STEP        ; GR1 &lt;- GR1 + 公差
        CPL     GR1,LST         ; GR1が末項より大きい場合は終了
        JPL     FIN             ; ↓
        JUMP    LOOP            ; ループ終端
FIN     ST      GR2,RST         ; GR2の結果をメモリーに転送
        RET
FST     DC      1               ; 初項
LST     DC      10              ; 末項
STEP    DC      1               ; 公差
RST     DS      1               ; 結果
        END
</pre></div>

<p><samp>sum_10.casl</samp>でプログラム終了時のGR2の値を確認するには、次のようにします。
</p>
<div class="example">
<pre class="example">$ <kbd>casl2 -t sum_10.casl | grep 'GR2:' | tail -1</kbd>
#000E: GR2:     55 = #0037 = 0000000000110111 = '7'
</pre></div>

<hr>
<span id="Step-count"></span><div class="header">
<p>
Previous: <a href="#End-value" accesskey="p" rel="prev">End value</a>, Up: <a href="#Register-and-memory" accesskey="u" rel="up">Register and memory</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<span id="puroguramunosutetupuShu-woBiao-Shi"></span><h4 class="subsection">2.3.3 プログラムのステップ数を表示</h4>

<p><code>grep</code>と<code>wc</code>を組み合わせれば、プログラムのステップ数を表示できます。
</p>
<div class="example">
<pre class="example">$ <kbd>casl2 -t hello.casl | grep 'GR1:' | wc -l</kbd>
11
</pre></div>

<div class="example">
<pre class="example">$ <kbd>casl2 -t addl.casl | grep 'GR1:' | wc -l</kbd>
3
</pre></div>

<p><samp>sum_10.casl</samp>はプログラム内にループがあるため、ステップ数が大きくなります。
</p>
<div class="example">
<pre class="example">$ <kbd>casl2 -t sum_10.casl | grep 'GR2:' | wc -l</kbd>
53
</pre></div>

<hr>
<span id="Only-assemble"></span><div class="header">
<p>
Next: <a href="#Analyze-word" accesskey="n" rel="next">Analyze word</a>, Previous: <a href="#Register-and-memory" accesskey="p" rel="prev">Register and memory</a>, Up: <a href="#Sample-usage" accesskey="u" rel="up">Sample usage</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<span id="asenburutoShi-Xing-woBie-niXing-u"></span><h3 class="section">2.4 アセンブルと実行を別に行う</h3>

<p><code>casl2</code>に<samp>-O</samp><samp>ファイル名</samp>を指定すると、オブジェクトファイルを作成できます。
</p>
<div class="example">
<pre class="example">$ <kbd>casl2 -Ohello.o hello.casl</kbd>
</pre></div>

<p>作成されたオブジェクトファイルの内容は、<code>od</code>を使って確認できます。
テキストファイルではないため、<code>cat</code>などでは確認できません。
</p>
<div class="example">
<pre class="example">$ <kbd>od -t x2 hello.o</kbd>
0000000 7001 0000 7002 0000 1210 0013 1220 0020
0000020 f000 0002 1210 0021 1220 0022 f000 0002
0000040 7120 7110 8100 0048 0065 006c 006c 006f
0000060 002c 0020 0057 006f 0072 006c 0064 0021
0000100 000d 000a 0001
0000106
</pre></div>

<p>オブジェクトファイルの実行には、<code>comet2</code>を使います。
</p>
<div class="example">
<pre class="example">$ <kbd>comet2 hello.o</kbd>
Hello, World!
</pre></div>

<hr>
<span id="Analyze-word"></span><div class="header">
<p>
Next: <a href="#Use-CASL2LIB" accesskey="n" rel="next">Use CASL2LIB</a>, Previous: <a href="#Only-assemble" accesskey="p" rel="prev">Only assemble</a>, Up: <a href="#Sample-usage" accesskey="u" rel="up">Sample usage</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<span id="g_t1Yu-noJie-Xi-"></span><h3 class="section">2.5 1語の解析</h3>

<p>CASL IIでは、1語（1 word、16ビット）を単位としてデータが処理されます。
<code>dumpword</code>は、指定した1語を10進数、16進数、2進数で表示します。
</p>
<div class="example">
<pre class="example">$ <kbd>dumpword 72</kbd>
    72:     72 = #0048 = 0000000001001000 = 'H'
</pre></div>

<hr>
<span id="Use-CASL2LIB"></span><div class="header">
<p>
Previous: <a href="#Analyze-word" accesskey="p" rel="prev">Analyze word</a>, Up: <a href="#Sample-usage" accesskey="u" rel="up">Sample usage</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<span id="CASL-IIraiburarinoShi-Yong-"></span><h3 class="section">2.6 CASL IIライブラリの使用</h3>

<p>YACASL2の<samp>as/casl2lib</samp>ディレクトリには、CASL IIで記述されたライブラリファイルが格納されています。
</p>
<p>このフォルダには、たとえば次のようなプログラムが含まれています。
</p>
<dl compact="compact">
<dt><samp>OUTL</samp></dt>
<dd><p><samp>outl.casl</samp>。
GR1に格納された値を、0以上65535以下の整数として出力します。
</p>
</dd>
<dt><samp>OUTA</samp></dt>
<dd><p><samp>outa.casl</samp>。
GR1に格納された値を、-32767以上32767以下の整数として出力します。
</p>
</dd>
<dt><samp>MULL</samp></dt>
<dd><p><samp>mull.casl</samp>。
GR1とGR2に格納された値を0以上65535以下の整数と見なし、積をGR3に格納します。
</p>
</dd>
<dt><samp>DIVL</samp></dt>
<dd><p><samp>divl.casl</samp>。
GR1とGR2に格納された値を0以上65535以下の整数と見なし、商をGR3、剰余をGR0に格納します。
</p></dd>
</dl>

<span id="Shu-Zhi-woChu-Li-suru"></span><h4 class="subsection">2.6.1 数値を出力する</h4>

<p>3と1の和を求める<samp>addl.casl</samp>で演算結果を出力するには、まず<samp>addl.casl</samp>を編集します。
CASL IIの<code>CALL</code>命令で<code>OUTL</code>を副プログラムとして呼び出します。
</p>
<div class="example">
<pre class="example">$ <kbd>cat addl_outl.casl</kbd>
MAIN    START
        LD      GR1,A
        ADDL    GR1,B
        <em>CALL    OUTL</em>
        RET
A       DC      3
B       DC      1
        END
</pre></div>

<p>変更したら<code>casl2</code>を、複数のファイルを指定して実行します。
</p>
<div class="example">
<pre class="example">$ <kbd>casl2 addl_outl.casl ~/yacasl2/as/casl2lib/outl.casl</kbd>
4
</pre></div>

<hr>
<span id="casl2-invocation"></span><div class="header">
<p>
Next: <a href="#comet2-invocation" accesskey="n" rel="next">comet2 invocation</a>, Previous: <a href="#Sample-usage" accesskey="p" rel="prev">Sample usage</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<span id="casl2noHu-biChu-si"></span><h2 class="chapter">3 <code>casl2</code>の呼び出し</h2>

<span id="index-casl2-1"></span>
<span id="index-casl2"></span>
<span id="index-invoking"></span>
<span id="index-options"></span>
<span id="index-usage"></span>
<span id="index-help"></span>

<p><code>casl2</code>は、引数として指定されたCASLファイルをアセンブルし、仮想マシンCOMET II上で実行します。
CASLファイルは、アセンブラ言語CASL IIで記述されたテキストファイルです。
引数が指定されない場合は、エラーメッセージを表示して終了します。
</p>
<div class="example">
<pre class="example">$ <kbd>casl2 hello.casl</kbd>
</pre></div>

<p>複数のCASLファイルを指定することで、副プログラムを呼び出すこともできます。
</p>
<div class="example">
<pre class="example">$ <kbd>casl2 addl_outl.casl ~/yacasl2/as/casl2lib/outl.casl</kbd>
</pre></div>

<span id="opusiyon"></span><h3 class="unnumberedsec">オプション</h3>

<p><code>casl2</code>は、次のオプションを指定できます。
</p>
<dl compact="compact">
<dt><samp>-s</samp></dt>
<dt><samp>--source</samp></dt>
<dd><p>CASLファイルの内容を表示します。
</p>
</dd>
<dt><samp>-l</samp></dt>
<dt><samp>--label</samp></dt>
<dd><p>ラベルの一覧を次の形式で表示します。
表示後、ほかの作業を続行します。
</p>
<div class="example">
<pre class="example">&lt;プログラム名&gt;.&lt;ラベル名&gt; ---&gt; &lt;アドレスの16進数表現&gt;
</pre></div>

</dd>
<dt><samp>-L</samp></dt>
<dt><samp>--labelonly</samp></dt>
<dd><p><samp>-l</samp>と同じ形式でラベルの一覧を表示します。
表示後、ほかの作業は続行せず、終了します。
</p>
</dd>
<dt><samp>-a</samp></dt>
<dt><samp>--assembledetail</samp></dt>
<dd><p>アセンブル詳細結果を表示し、ほかの作業を続行します。
</p>
</dd>
<dt><samp>-A</samp></dt>
<dt><samp>--assembledetailonly</samp></dt>
<dd><p>アセンブル詳細結果を表示して終了します。
</p>
</dd>
<dt><samp>-o&lt;OBJECTFILE&gt;</samp></dt>
<dt><samp>--assembleout&lt;OBJECTFILE&gt;</samp></dt>
<dd><p>アセンブル結果をオブジェクトファイル<samp>&lt;OBJECTFILE&gt;</samp>に出力し、ほかの作業を続行します。
出力されたオブジェクトファイルは、<code>comet2</code>で実行できます。
オブジェクトファイルを指定しない場合、出力先は<samp>a.o</samp>です。
オブジェクトファイルは1つだけ指定できます。
</p>
</dd>
<dt><samp>-O[&lt;OBJECTFILE&gt;]</samp></dt>
<dt><samp>--assembleoutonly[&lt;OBJECTFILE&gt;]</samp></dt>
<dd><p>アセンブル結果をオブジェクトファイル<samp>&lt;OBJECTFILE&gt;</samp>に出力し、終了します。
出力されたオブジェクトファイルは、<code>comet2</code>で実行できます。
オブジェクトファイルを指定しない場合、出力先は<samp>a.o</samp>です。
オブジェクトファイルは1つだけ指定できます。
</p>
</dd>
<dt><samp>-t</samp></dt>
<dt><samp>--trace</samp></dt>
<dt><samp>--tracearithmetic</samp></dt>
<dd><p>プログラム実行中のレジスタの値を次の形式で表示します。
</p>
<div class="example">
<pre class="example">&lt;PR値の16進数表現&gt;: &lt;レジスタ&gt;: &lt;値の10進数表現&gt; =
&lt;値の16進数表現&gt; = &lt;値の2進数表現&gt;[ ='文字']
</pre></div>

<ul>
<li> <code>&lt;PR値の16進数表現&gt;</code>と<code>&lt;レジスタ&gt;</code>、<code>&lt;値の16進数表現&gt;</code>は、4けたの16進数で表されます。
<code>&lt;PR値の16進数表現&gt;</code>と<code>&lt;値の16進数表現&gt;</code>には、先頭に<code>#</code>が付きます。
範囲は<code>#0000</code>から<code>#FFFF</code>です

</li><li> <code>&lt;値の10進数表現&gt;</code>は符号の付いた10進数です。
範囲は-32768から32767です。

</li><li> <code>&lt;値の2進数表現&gt;</code>は、16けたの2進数で表されます。
範囲は、<code>0000000000000000</code>から<code>1111111111111111</code>です

</li><li> <code>[ ='文字']</code>は、レジストリの値が「文字の組」の範囲に含まれる場合に表示されます。
</li></ul>

<p>表示されるレジスタには、次の種類があります。
</p>
<dl compact="compact">
<dt><code>GR0 GR1 GR2 GR3 GR4 GR5 GR6 GR7</code></dt>
<dd><p>汎用レジスタ
</p>
</dd>
<dt><code>SP</code></dt>
<dd><p>スタックポインタ
</p>
</dd>
<dt><code>PR</code></dt>
<dd><p>プログラムレジスタ
</p>
</dd>
<dt><code>FR</code></dt>
<dd><p>フラグレジスタ
</p></dd>
</dl>

<p>例えば、次のように表示されます。
</p>
<div class="example">
<pre class="example">#0002: GR1:      3 = #0003 = 0000000000000011
</pre></div>

</dd>
<dt><samp>-T</samp></dt>
<dt><samp>--tracelogical</samp></dt>
<dd><p><samp>-t</samp>と同じように、プログラム実行中のレジスタの値を表示します。
ただし<samp>-t</samp>と異なり、<code>&lt;値の10進数表現&gt;</code>は符号の付かない10進数です。
値の範囲は0から65535です。
</p>
</dd>
<dt><samp>-d</samp></dt>
<dt><samp>--dump</samp></dt>
<dd><p>メモリの内容をすべて表示します。
</p>
</dd>
<dt><samp>-M &lt;MEMORYSIZE&gt;</samp></dt>
<dt><samp>--memorysize &lt;MEMORYSIZE&gt;</samp></dt>
<dd><p>アセンブルおよび実行時のメモリサイズ<samp>&lt;MEMORYSIZE&gt;</samp>を0から65535の範囲で指定します。
指定しない場合、512です。
</p>
</dd>
<dt><samp>-C &lt;CLOCKS&gt;</samp></dt>
<dt><samp>--clocks &lt;CLOCKS&gt;</samp></dt>
<dd><p>実行時のクロック周波数<samp>&lt;CLOCKS&gt;</samp>を0より大きい整数で指定します。
指定しない場合、クロック周波数は5000000です。
</p>
</dd>
<dt><samp>-v</samp></dt>
<dt><samp>--version</samp></dt>
<dd><p><code>casl2</code>のバージョンを表示して終了します。
</p>
</dd>
<dt><samp>-h</samp></dt>
<dt><samp>--help</samp></dt>
<dd><p><code>casl2</code>の使用方法を表示して終了します。
</p></dd>
</dl>

<hr>
<span id="comet2-invocation"></span><div class="header">
<p>
Next: <a href="#dumpword-invocation" accesskey="n" rel="next">dumpword invocation</a>, Previous: <a href="#casl2-invocation" accesskey="p" rel="prev">casl2 invocation</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<span id="comet2noHu-biChu-si"></span><h2 class="chapter">4 <code>comet2</code>の呼び出し</h2>

<span id="index-comet2-1"></span>
<span id="index-comet2"></span>
<span id="index-invoking-1"></span>
<span id="index-options-1"></span>
<span id="index-usage-1"></span>
<span id="index-help-1"></span>

<p><code>comet2</code>は、引数として指定されたオブジェクトファイルを仮想マシンCOMET II上で実行します。
オブジェクトファイルは、<code>casl</code>に<samp>-o</samp>または<samp>-O</samp>を指定して出力します。
</p>
<div class="example">
<pre class="example">$ <kbd>comet2 hello.o</kbd>
</pre></div>

<p>引数で指定できるオブジェクトファイルは1つだけです。
引数が指定されない場合は、エラーメッセージを表示して終了します。
複数の引数を指定した場合、2番目以降の引数は無視されます。
</p>
<span id="opusiyon-1"></span><h3 class="unnumberedsec">オプション</h3>

<p><code>comet2</code>は、次のオプションを指定できます。
</p>
<dl compact="compact">
<dt><samp>-t</samp></dt>
<dt><samp>--trace</samp></dt>
<dt><samp>--tracearithmetic</samp></dt>
<dd><p>プログラム実行中のレジスタの値を次の形式で表示します。
<code>&lt;値の10進数表現&gt;</code>は符号の付いた10進数です。
範囲は-32768から32767です。
</p>
<div class="example">
<pre class="example">&lt;PR値の16進数表現&gt;: &lt;レジスタ&gt;: &lt;値の10進数表現&gt; = &lt;値の16進数表現&gt; = &lt;値の2進数表現&gt;[ ='文字']
</pre></div>

<ul>
<li> <code>&lt;PR値の16進数表現&gt;</code>と<code>&lt;値の16進数表現&gt;</code>は、先頭に<code>#</code>が付いた4けたの16進数で表されます。
範囲は、<code>#0000</code>から<code>#FFFF</code>です

</li><li> <code>&lt;値の2進数表現&gt;</code>は、16けたの2進数で表されます。
範囲は、<code>0000000000000000</code>から<code>1111111111111111</code>です

</li><li> <code>[ ='文字']</code>は、レジストリの値が「文字の組」の範囲に含まれる場合に表示されます。
</li></ul>

<p>例えば、次のように表示されます。
</p>
<div class="example">
<pre class="example">#0002: GR1:      3 = #0003 = 0000000000000011
</pre></div>

<p>表示されるレジスタには、次の種類があります。
</p>
<dl compact="compact">
<dt><code>GR0 GR1 GR2 GR3 GR4 GR5 GR6 GR7</code></dt>
<dd><p>汎用レジスタ
</p>
</dd>
<dt><code>SP</code></dt>
<dd><p>スタックポインタ
</p>
</dd>
<dt><code>PR</code></dt>
<dd><p>プログラムレジスタ
</p>
</dd>
<dt><code>FR</code></dt>
<dd><p>フラグレジスタ
</p></dd>
</dl>

</dd>
<dt><samp>-T</samp></dt>
<dt><samp>--tracelogical</samp></dt>
<dd><p><samp>-t</samp>と同じように、プログラム実行中のレジスタの値を表示します。
ただし、<samp>-t</samp>と異なり、<code>&lt;値の10進数表現&gt;</code>は符号の付かない10進数です。
値の範囲は0から65535です。
</p>
</dd>
<dt><samp>-d</samp></dt>
<dt><samp>--dump</samp></dt>
<dd><p>メモリの内容をすべて表示します。
</p>
</dd>
<dt><samp>-M &lt;MEMORYSIZE&gt;</samp></dt>
<dt><samp>--memorysize &lt;MEMORYSIZE&gt;</samp></dt>
<dd><p>実行時のメモリサイズ<samp>&lt;MEMORYSIZE&gt;</samp>を0から65535の範囲で指定します。
指定しない場合、512です。
</p>
</dd>
<dt><samp>-C &lt;CLOCKS&gt;</samp></dt>
<dt><samp>--clocks &lt;CLOCKS&gt;</samp></dt>
<dd><p>実行時のクロック周波数<samp>&lt;CLOCKS&gt;</samp>を0より大きい整数で指定します。
指定しない場合、5000000です。
</p>
</dd>
<dt><samp>-v</samp></dt>
<dt><samp>--version</samp></dt>
<dd><p><code>comet2</code>のバージョンを表示して終了します。
</p>
</dd>
<dt><samp>-h</samp></dt>
<dt><samp>--help</samp></dt>
<dd><p><code>comet2</code>の使用方法を表示して終了します。
</p></dd>
</dl>

<hr>
<span id="dumpword-invocation"></span><div class="header">
<p>
Previous: <a href="#comet2-invocation" accesskey="p" rel="prev">comet2 invocation</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>]</p>
</div>
<span id="dumpwordnoHu-biChu-si"></span><h2 class="chapter">5 <code>dumpword</code>の呼び出し</h2>

<span id="index-dumpword-1"></span>
<span id="index-dumpword"></span>
<span id="index-invoking-2"></span>
<span id="index-options-2"></span>
<span id="index-usage-2"></span>
<span id="index-help-2"></span>

<p><code>dumpword</code>は引数として指定された数値を、整数、#0000から#FFFFまでの範囲の16進数、2進数で表示します。
文字の組に該当する場合は、「 = 」のうしろに文字が表示されます。
引数は、10進数または先頭に「#」の付いた16進数で指定します。
表示される整数は、オプションにより符号付きか符号なしかを指定します。
オプションなしの場合は符号付きです。
整数の範囲は、符号付きの場合は-32768以上32767以下、符号なしの場合は0以上65535以下です。
</p>
<div class="example">
<pre class="example">$ <kbd>dumpword 10</kbd>
    10:     10 = #000A = 0000000000001010 = '\n'
</pre></div>

<p>引数が指定されない場合は、使い方を表示して終了します。
複数の引数を指定した場合、1つ目の引数だけが表示され、2つ目以降の引数は無視されます。
</p>
<span id="Zhu-Yi-"></span><h3 class="unnumberedsec">注意</h3>

<p>マイナスの数や16進数はシェルの仕様により、そのままでは指定できません。
</p>
<p>マイナスの数を指定するときは、次のように<samp>--</samp>を付けます。
</p>
<div class="example">
<pre class="example">$ <kbd>dumpword -- -72</kbd>
   -72:    -72 = #FFB8 = 1111111110111000
</pre></div>

<p>先頭に「#」を付けて16進数を指定するときは、次のように「&rsquo;」で囲みます。
</p>
<div class="example">
<pre class="example">$ <kbd>dumpword '#0048'</kbd>
 #0048:     72 = #0048 = 0000000001001000 = 'H'
</pre></div>

<span id="opusiyon-2"></span><h3 class="unnumberedsec">オプション</h3>

<p><code>dumpword</code>は、次のオプションを指定できます。
</p>
<dl compact="compact">
<dt><samp>-a</samp></dt>
<dt><samp>--arithmetic</samp></dt>
<dd><p>出力される整数の範囲を-32,768以上32,767以下にします。
オプションなしの場合と同じです。
</p>
</dd>
<dt><samp>-l</samp></dt>
<dt><samp>--logical</samp></dt>
<dd><p>出力される整数の範囲を0以上65,535以下にします。
</p>
</dd>
<dt><samp>-v</samp></dt>
<dt><samp>--version</samp></dt>
<dd><p><code>dumpword</code>のバージョンを表示して終了します。
</p>
</dd>
<dt><samp>-h</samp></dt>
<dt><samp>--help</samp></dt>
<dd><p><code>dumpword</code>の使用方法を表示して終了します。
</p></dd>
</dl>

<hr>



</body>
</html>
/* [<][>][^][v][top][bottom][index][help] */