# b2c2
BASIC言語風の独自のプログラミング言語(?)のソースコードファイルからCASL2のソースコードファイルを生成しました
-------------------------------------------------------------------------------
- 生成されたCASL2コードの動作確認にはCASL2アセンブラ/COMET2シミュレータ等を別途用意する必要があります
- 生成コードの最適化等はしてません(無意味・無駄・冗長な処理が複数あります。例: 分岐によるジャンプ処理などはラベルをつけた`NOP`で実現、など)
- リポジトリの*basic_src_examples*にあるCASL2コードはIPAのCASL II シミュレータ（Java,V2.00(2005/05/27))で一応は動作確認済みです
-------------------------------------------------------------------------------
### Example: Fizz Buzz (その1)
リポジトリの *basic_src_examples/fizz_buzz_1/* のディレクトリに入力のBASICファイルと出力のCASL2ファイルがあります
生成コマンド: `cargo run -- -src fizzbuzz.bas` (*basic_src_examples/fizz_buzz_1/* での実行を想定)
入力ファイル: *basic_src_examples/fizz_buzz_1/fizzbuzz.bas*
```vb
'
' FIZZ BUZZ (1)
'
DIM I AS INTEGER
DIM C AS INTEGER
PRINT "LIMIT?"
INPUT C
C = MAX(1, MIN(100, C))
FOR I = 1 TO C STEP 1
SELECT CASE I MOD 15
CASE 0
PRINT "FIZZBUZZ"
CASE 3, 6, 9, 12
PRINT "FIZZ"
CASE 5, 10
PRINT "BUZZ"
CASE ELSE
PRINT I
END SELECT
NEXT I
```
<details>
<summary>出力ファイル: <i>basic_src_examples/fizz_buzz_1/MAIN.cas</i></summary>
<pre><code>MAIN START
RPUSH
; Init Variables
LAD GR1,I001
XOR GR2,GR2
LAD GR3,2
CALL C010
; Print "LIMIT?"
OUT LB001,LL001
; Input C
IN TB001,TL001
XOR GR0,GR0
ST GR0,EOF
LAD GR1,TB001
LD GR2,TL001
JPL J004
JZE J004
ST GR2,EOF
XOR GR2,GR2
J004 CALL C000
ST GR0,I002
; C = Max(1, Min(100, C))
LAD GR7,1
LAD GR6,100
LD GR5,I002
CPA GR6,GR5
JMI J005
LD GR6,GR5
J005 NOP
CPA GR7,GR6
JPL J006
LD GR7,GR6
J006 NOP
ST GR7,I002
; For I = 1 To C Step 1
LD GR7,I002
ST GR7,T001
LAD GR7,1
ST GR7,I001
J007 NOP
LD GR1,I001
CPA GR1,T001
JPL J009
; Select Case (I Mod 15)
LD GR7,I001
LAD GR6,15
LD GR3,GR6
LD GR2,GR7
CALL C009
LD GR0,GR1
LD GR7,GR0
CPA GR7,=0
JZE J010
CPA GR7,=3
JZE J011
CPA GR7,=6
JZE J011
CPA GR7,=9
JZE J011
CPA GR7,=12
JZE J011
CPA GR7,=5
JZE J012
CPA GR7,=10
JZE J012
JUMP J013
; Case 0
J010 NOP
; Print "FIZZBUZZ"
OUT LB002,LL002
JUMP J029
; Case 3, 6, 9, 12
J011 NOP
; Print "FIZZ"
OUT LB003,LL003
JUMP J029
; Case 5, 10
J012 NOP
; Print "BUZZ"
OUT LB004,LL004
JUMP J029
; Case Else
J013 NOP
; Print I
LD GR7,I001
LD GR3,GR7
LAD GR1,TB001
LAD GR2,TL001
CALL C002
OUT TB001,TL001
; End Select
J029 NOP
; Next I
J008 NOP
LAD GR1,I001
LD GR2,0,GR1
LAD GR2,1,GR2
ST GR2,0,GR1
JUMP J007
J009 NOP
EXIT NOP
RPOP
RET
; Dim I As Integer
I001 DS 1
; Dim C As Integer
I002 DS 1
EOF DS 1
T001 DS 1
TL001 DS 1
TB001 DS 256
LL001 DC 6
LB001 DC 'LIMIT?'
LL002 DC 8
LB002 DC 'FIZZBUZZ'
LL003 DC 4
LB003 DC 'FIZZ'
LL004 DC 4
LB004 DC 'BUZZ'
; FuncCInt
C000 PUSH 0,GR1
PUSH 0,GR2
PUSH 0,GR3
PUSH 0,GR4
PUSH 0,GR5
ADDL GR2,GR1
XOR GR0,GR0
XOR GR4,GR4
CPL GR1,GR2
JZE J001
LD GR3,0,GR1
CPL GR3,='+'
JNZ J003
LAD GR1,1,GR1
JUMP J002
J003 CPL GR3,='-'
JNZ J002
LAD GR4,-1
LAD GR1,1,GR1
J002 CPL GR1,GR2
JZE J001
LD GR3,0,GR1
SUBL GR3,='0'
JMI J001
CPL GR3,=9
JPL J001
LD GR5,GR0
SLL GR0,3
ADDL GR0,GR5
ADDL GR0,GR5
ADDL GR0,GR3
LAD GR1,1,GR1
JUMP J002
J001 XOR GR0,GR4
SUBL GR0,GR4
POP GR5
POP GR4
POP GR3
POP GR2
POP GR1
RET
; FuncCStrArgInt
C002 CPL GR3,=#8000
JNZ J030
PUSH 0,GR3
PUSH 0,GR4
LAD GR3,='-32768'
LAD GR4,6
CALL C007
POP GR4
POP GR3
RET
J030 AND GR3,GR3
JNZ J031
LAD GR3,1
ST GR3,0,GR2
LD GR3,='0'
ST GR3,0,GR1
XOR GR3,GR3
RET
J031 PUSH 0,GR1
PUSH 0,GR2
PUSH 0,GR3
PUSH 0,GR4
PUSH 0,GR5
JPL J032
LD GR4,='-'
ST GR4,0,GR1
LAD GR1,1,GR1
XOR GR3,=#FFFF
LAD GR3,1,GR3
J032 LAD GR4,V001
LD GR5,GR1
LD GR2,GR3
LAD GR3,10
J033 CALL C009
ADDL GR1,='0'
ST GR1,0,GR4
LAD GR4,1,GR4
LD GR2,GR0
JPL J033
LAD GR2,V001
LAD GR4,-1,GR4
J034 LD GR1,0,GR4
ST GR1,0,GR5
LAD GR5,1,GR5
LAD GR4,-1,GR4
CPL GR4,GR2
JPL J034
JZE J034
LD GR0,GR5
POP GR5
POP GR4
POP GR3
POP GR2
POP GR1
SUBL GR0,GR1
ST GR0,0,GR2
RET
V001 DS 6
; UtilCopyStr
C007 PUSH 0,GR1
PUSH 0,GR2
PUSH 0,GR3
PUSH 0,GR4
ST GR4,0,GR2
AND GR4,GR4
JZE J036
J035 LD GR2,0,GR3
ST GR2,0,GR1
LAD GR3,1,GR3
LAD GR1,1,GR1
SUBL GR4,=1
JPL J035
J036 POP GR4
POP GR3
POP GR2
POP GR1
RET
; UtilDivMod
C009 AND GR3,GR3
JNZ J016
XOR GR0,GR0
LAD GR1,-1
RET
J016 PUSH 0,GR2
PUSH 0,GR3
PUSH 0,GR4
PUSH 0,GR5
LD GR4,GR2
LD GR5,GR2
JPL J014
XOR GR5,GR5
SUBA GR5,GR2
J014 LD GR1,GR3
JPL J015
XOR GR1,GR1
SUBA GR1,GR3
J015 LAD GR0,1
J017 ADDL GR1,GR1
JOV J018
ADDL GR0,GR0
JUMP J017
J018 SRL GR1,1
LAD GR1,#8000,GR1
XOR GR2,GR2
J019 CPL GR5,GR1
JMI J020
SUBL GR5,GR1
ADDL GR2,GR0
J020 SRL GR0,1
JZE J021
SRL GR1,1
JUMP J019
J021 LD GR5,GR4
XOR GR5,GR3
SRA GR5,15
XOR GR2,GR5
SUBA GR2,GR5
CALL C012
LD GR1,GR4
SUBA GR1,GR0
LD GR0,GR2
POP GR5
POP GR4
POP GR3
POP GR2
RET
; UtilFill
C010 PUSH 0,GR1
PUSH 0,GR2
PUSH 0,GR3
ADDL GR3,GR1
J037 CPL GR1,GR3
JZE J038
ST GR2,0,GR1
LAD GR1,1,GR1
JUMP J037
J038 POP GR3
POP GR2
POP GR1
RET
; UtilMul
C012 PUSH 0,GR2
PUSH 0,GR3
PUSH 0,GR4
PUSH 0,GR5
XOR GR0,GR0
XOR GR1,GR1
LD GR4,GR2
LD GR5,GR3
J022 SRL GR2,1
JOV J023
JNZ J025
JUMP J026
J023 ADDL GR0,GR3
JOV J024
JUMP J025
J024 LAD GR1,1,GR1
J025 SLL GR3,1
JUMP J022
J026 SRL GR5,1
SLL GR4,1
JOV J027
JNZ J026
JUMP J028
J027 ADDL GR1,GR5
JUMP J026
J028 POP GR5
POP GR4
POP GR3
POP GR2
RET
END
</code></pre>
</details>
<details>
<summary>シミュレータ等による実行例</summary>
<pre><samp>LIMIT?
<i>?</i> <b>20</b>
1
2
FIZZ
4
BUZZ
FIZZ
7
8
FIZZ
BUZZ
11
FIZZ
13
14
FIZZBUZZ
16
17
FIZZ
19
BUZZ
</samp></pre>
</details>
-------------------------------------------------------------------------------
### Example: Fizz Buzz (その2)
リポジトリの *basic_src_examples/fizz_buzz_2/* のディレクトリに入力のBASICファイルと出力のCASL2ファイルがあります
生成コマンド: `cargo run -- -src fizzbuzz.bas` (*basic_src_examples/fizz_buzz_2/* での実行を想定)
入力ファイル: *basic_src_examples/fizz_buzz_2/fizzbuzz.bas*
```vb
'
' FIZZ BUZZ (2)
'
Dim s As String
Dim n As Integer
Do
Print "Number?"
Input s
If s = "end" Then
Exit Do
End If
n = CInt(s)
If n < 1 Then
Print "Invalid Input"
Continue Do
End If
If n Mod 15 = 0 Then
s = "FizzBuzz"
ElseIf n Mod 3 = 0 Then
s = "Fizz"
ElseIf n Mod 5 = 0 Then
s = "Buzz"
Else
s = CStr(n)
End If
Print s
Loop
```
<details>
<summary>出力ファイル: <i>basic_src_examples/fizz_buzz_2/MAIN.cas</i></summary>
<pre><code>MAIN START
RPUSH
; Init Variables
LAD GR1,I002
XOR GR2,GR2
LAD GR3,258
CALL C010
; Do
J001 NOP
; Print "Number?"
OUT LB001,LL001
; Input s
IN SB001,SL001
XOR GR0,GR0
ST GR0,EOF
LD GR0,SL001
JPL J003
JZE J003
ST GR0,EOF
XOR GR0,GR0
ST GR0,SL001
J003 NOP
; If (s = "end") Then
LAD GR1,SB001
LD GR2,SL001
LAD GR3,='end'
LAD GR4,3
CALL C004
SLL GR0,15
SRA GR0,15
XOR GR0,=#FFFF
LD GR7,GR0
AND GR7,GR7
JZE J004
; Exit Do
JUMP J002
; End If
J004 NOP
; n = CInt(s)
LAD GR1,SB001
LD GR2,SL001
CALL C000
LD GR7,GR0
ST GR7,I002
; If (n < 1) Then
LD GR7,I002
LAD GR6,1
LAD GR0,#FFFF
CPA GR7,GR6
JMI J014
XOR GR0,GR0
J014 LD GR7,GR0
AND GR7,GR7
JZE J013
; Print "Invalid Input"
OUT LB002,LL002
; Continue Do
JUMP J001
; End If
J013 NOP
; If ((n Mod 15) = 0) Then
LD GR7,I002
LAD GR6,15
LD GR3,GR6
LD GR2,GR7
CALL C009
LD GR0,GR1
LD GR7,GR0
XOR GR6,GR6
SUBA GR7,GR6
JZE J034
LAD GR7,#FFFF
J034 XOR GR7,=#FFFF
AND GR7,GR7
JZE J016
; s = "FizzBuzz"
LAD GR1,SB001
LAD GR2,SL001
LAD GR3,='FizzBuzz'
LAD GR4,8
CALL C007
JUMP J015
; ElseIf ((n Mod 3) = 0) Then
J016 NOP
LD GR7,I002
LAD GR6,3
LD GR3,GR6
LD GR2,GR7
CALL C009
LD GR0,GR1
LD GR7,GR0
XOR GR6,GR6
SUBA GR7,GR6
JZE J037
LAD GR7,#FFFF
J037 XOR GR7,=#FFFF
AND GR7,GR7
JZE J017
; s = "Fizz"
LAD GR1,SB001
LAD GR2,SL001
LAD GR3,='Fizz'
LAD GR4,4
CALL C007
JUMP J015
; ElseIf ((n Mod 5) = 0) Then
J017 NOP
LD GR7,I002
LAD GR6,5
LD GR3,GR6
LD GR2,GR7
CALL C009
LD GR0,GR1
LD GR7,GR0
XOR GR6,GR6
SUBA GR7,GR6
JZE J038
LAD GR7,#FFFF
J038 XOR GR7,=#FFFF
AND GR7,GR7
JZE J018
; s = "Buzz"
LAD GR1,SB001
LAD GR2,SL001
LAD GR3,='Buzz'
LAD GR4,4
CALL C007
JUMP J015
; Else
J018 NOP
; s = CStr(n)
LD GR7,I002
LD GR3,GR7
LAD GR1,TB001
LAD GR2,TL001
CALL C002
LAD GR1,SB001
LAD GR2,SL001
LAD GR3,TB001
LD GR4,TL001
CALL C007
; End If
J015 NOP
; Print s
OUT SB001,SL001
; Loop
JUMP J001
J002 NOP
EXIT NOP
RPOP
RET
; Dim n As Integer
I002 DS 1
; Dim s As String
SL001 DS 1
SB001 DS 256
EOF DS 1
TL001 DS 1
TB001 DS 256
LL001 DC 7
LB001 DC 'Number?'
LL002 DC 13
LB002 DC 'Invalid Input'
; FuncCInt
C000 PUSH 0,GR1
PUSH 0,GR2
PUSH 0,GR3
PUSH 0,GR4
PUSH 0,GR5
ADDL GR2,GR1
XOR GR0,GR0
XOR GR4,GR4
CPL GR1,GR2
JZE J010
LD GR3,0,GR1
CPL GR3,='+'
JNZ J012
LAD GR1,1,GR1
JUMP J011
J012 CPL GR3,='-'
JNZ J011
LAD GR4,-1
LAD GR1,1,GR1
J011 CPL GR1,GR2
JZE J010
LD GR3,0,GR1
SUBL GR3,='0'
JMI J010
CPL GR3,=9
JPL J010
LD GR5,GR0
SLL GR0,3
ADDL GR0,GR5
ADDL GR0,GR5
ADDL GR0,GR3
LAD GR1,1,GR1
JUMP J011
J010 XOR GR0,GR4
SUBL GR0,GR4
POP GR5
POP GR4
POP GR3
POP GR2
POP GR1
RET
; FuncCStrArgInt
C002 CPL GR3,=#8000
JNZ J039
PUSH 0,GR3
PUSH 0,GR4
LAD GR3,='-32768'
LAD GR4,6
CALL C007
POP GR4
POP GR3
RET
J039 AND GR3,GR3
JNZ J040
LAD GR3,1
ST GR3,0,GR2
LD GR3,='0'
ST GR3,0,GR1
XOR GR3,GR3
RET
J040 PUSH 0,GR1
PUSH 0,GR2
PUSH 0,GR3
PUSH 0,GR4
PUSH 0,GR5
JPL J041
LD GR4,='-'
ST GR4,0,GR1
LAD GR1,1,GR1
XOR GR3,=#FFFF
LAD GR3,1,GR3
J041 LAD GR4,V001
LD GR5,GR1
LD GR2,GR3
LAD GR3,10
J042 CALL C009
ADDL GR1,='0'
ST GR1,0,GR4
LAD GR4,1,GR4
LD GR2,GR0
JPL J042
LAD GR2,V001
LAD GR4,-1,GR4
J043 LD GR1,0,GR4
ST GR1,0,GR5
LAD GR5,1,GR5
LAD GR4,-1,GR4
CPL GR4,GR2
JPL J043
JZE J043
LD GR0,GR5
POP GR5
POP GR4
POP GR3
POP GR2
POP GR1
SUBL GR0,GR1
ST GR0,0,GR2
RET
V001 DS 6
; UtilCompareStr
C004 PUSH 0,GR1
PUSH 0,GR2
PUSH 0,GR3
PUSH 0,GR4
PUSH 0,GR5
XOR GR0,GR0
J005 AND GR2,GR2
JPL J006
CPL GR2,GR4
JNZ J007
JUMP J009
J006 AND GR4,GR4
JZE J008
LD GR5,0,GR1
CPL GR5,0,GR3
JMI J007
JPL J008
LAD GR1,1,GR1
LAD GR2,-1,GR2
LAD GR3,1,GR3
LAD GR4,-1,GR4
JUMP J005
J007 LAD GR0,-1
J008 OR GR0,=1
J009 POP GR5
POP GR4
POP GR3
POP GR2
POP GR1
RET
; UtilCopyStr
C007 PUSH 0,GR1
PUSH 0,GR2
PUSH 0,GR3
PUSH 0,GR4
ST GR4,0,GR2
AND GR4,GR4
JZE J036
J035 LD GR2,0,GR3
ST GR2,0,GR1
LAD GR3,1,GR3
LAD GR1,1,GR1
SUBL GR4,=1
JPL J035
J036 POP GR4
POP GR3
POP GR2
POP GR1
RET
; UtilDivMod
C009 AND GR3,GR3
JNZ J021
XOR GR0,GR0
LAD GR1,-1
RET
J021 PUSH 0,GR2
PUSH 0,GR3
PUSH 0,GR4
PUSH 0,GR5
LD GR4,GR2
LD GR5,GR2
JPL J019
XOR GR5,GR5
SUBA GR5,GR2
J019 LD GR1,GR3
JPL J020
XOR GR1,GR1
SUBA GR1,GR3
J020 LAD GR0,1
J022 ADDL GR1,GR1
JOV J023
ADDL GR0,GR0
JUMP J022
J023 SRL GR1,1
LAD GR1,#8000,GR1
XOR GR2,GR2
J024 CPL GR5,GR1
JMI J025
SUBL GR5,GR1
ADDL GR2,GR0
J025 SRL GR0,1
JZE J026
SRL GR1,1
JUMP J024
J026 LD GR5,GR4
XOR GR5,GR3
SRA GR5,15
XOR GR2,GR5
SUBA GR2,GR5
CALL C012
LD GR1,GR4
SUBA GR1,GR0
LD GR0,GR2
POP GR5
POP GR4
POP GR3
POP GR2
RET
; UtilFill
C010 PUSH 0,GR1
PUSH 0,GR2
PUSH 0,GR3
ADDL GR3,GR1
J044 CPL GR1,GR3
JZE J045
ST GR2,0,GR1
LAD GR1,1,GR1
JUMP J044
J045 POP GR3
POP GR2
POP GR1
RET
; UtilMul
C012 PUSH 0,GR2
PUSH 0,GR3
PUSH 0,GR4
PUSH 0,GR5
XOR GR0,GR0
XOR GR1,GR1
LD GR4,GR2
LD GR5,GR3
J027 SRL GR2,1
JOV J028
JNZ J030
JUMP J031
J028 ADDL GR0,GR3
JOV J029
JUMP J030
J029 LAD GR1,1,GR1
J030 SLL GR3,1
JUMP J027
J031 SRL GR5,1
SLL GR4,1
JOV J032
JNZ J031
JUMP J033
J032 ADDL GR1,GR5
JUMP J031
J033 POP GR5
POP GR4
POP GR3
POP GR2
RET
END
</code></pre>
</details>
<details>
<summary>シミュレータ等による実行例</summary>
<pre><samp>Number?
<i>?</i> <b>1</b>
1
Number?
<i>?</i> <b>2</b>
2
Number?
<i>?</i> <b>3</b>
Fizz
Number?
<i>?</i> <b>4</b>
4
Number?
<i>?</i> <b>5</b>
Buzz
Number?
<i>?</i> <b>11</b>
11
Number?
<i>?</i> <b>15</b>
FizzBuzz
Number?
<i>?</i> <b>end</b>
</samp></pre>
</details>
-------------------------------------------------------------------------------
### その他
##### b2c2の実行に関して
- b2c2の実行バイナリの提供はありません。ソースコードからビルドして実行してください
- b2c2はCLI(command-line interface)のアプリです。出力するメッセージに日本語が含まれることがあるため日本語表示が可能なシェルやコマンドプロンプトを使用する必要があります
- 網羅的にチェックはしてないのでBASICコード次第では期待どおりの動作をしないCASL2コードが生成される可能性もあります
- BASICソースコードは**UTF-8**(BOMなし)で文字エンコーディングされたファイルとみなして読み込みます
- 生成のCASL2ソースコードは**UTF-8**(BOMなし)の文字エンコーディングで出力されます
- 文字数の埋め込みがある場合はUnicodeスカラ値の個数を文字数として埋め込みます
- b2c2のBASIC言語についてはリポジトリの*doc/language.md*に概要が書いてあります
##### b2c2のビルドに関して
- rustcのバージョンは**1.58.0**、cargoのバージョンは**1.58.0**を使用しました (他のバージョンでコンパイル可能かは未確認です)
- toolchainは**stable-i686-pc-windows-msvc**を使用しました (toolchainは実行環境や開発環境に合わせて選択するものですが、他のtoolchainでb2c2をコンパイル可能かは未確認です)
- Editionは**2021**を使用。標準ライブラリを使用しており、外部ライブラリは直接使用してません
##### b2c2のビルドと実行の例
ソースコードを取得してFizz Buzz (その1)を変換しFizz Buzz (その2)を変換するまでの一連のコマンドライン
※gitとcargoの両方ともインストール済みとします
※この例の場合では初回の`cargo run`実行時にb2c2が暗黙的にビルドされます
```bash
git clone https://github.com/neetsdkasu/b2c2
cd b2c2
cd basic_src_examples
cd fizz_buzz_1
cargo run -- -src fizzbuzz.bas
cd ..
cd fizz_buzz_2
cargo run -- -src fizzbuzz.bas
```
##### b2c2をインストールして使う場合
※cargoをインストール済みとします
- インストール
※`cargo install`がソースコードの取得とビルドと実行バイナリの配置を行います
```bash
cargo install --git https://github.com/neetsdkasu/b2c2 --branch main
```
- 実行
※BASICのソースコードファイルは適宜用意してください
```bash
b2c2 -src BASICのソースコードファイル
```
- アンインストール
※実行バイナリの削除のみ。インストール時に取得されたソースコード等はどこかに残ったままのようです
```bash
cargo uninstall b2c2
```
##### 閑話
<details>
<summary>個人的な話</summary>
<ul>
<li>事前の設計などはなく思いつくまま実装していったためスパゲティコード化しておりメンテナンスや改造は難しいです</li>
<li>プログラミング言語の作り方やコンパイラの作り方は不勉強であり、b2c2の作成にあたってはかなりデタラメです (一般的にはコンパイラコンパイラなどを使用するものと思われます)</li>
<li>BASICのコードからCASL2のコードに変換に際し中間コードのようなものは使用してません (CASL2変換後にメタ情報が失われるためそのままでの最適化は難しいかもしれません)</li>
<li>テストコードがいくつかありますが<code>cargo run</code>の代わりに<code>cargo test</code>を実行していたようなものなので本来のテストと呼ばれるものとは異なる使い方をしてます (全てのテストがpassedしても動作を保証するものではありません)</li>
<li>Rustに関しても不勉強なため無駄な処理や無意味な処理も多いかもしれません</li>
<li>b2c2の作成にRustを選択しておりますが特に理由はありません。標準入出力処理とファイル操作さえ出来れば十分でしたのでRustを選択する必要性は皆無でその時の気分でRustを選んだにすぎません</li>
</ul>
</details>