文法

文

• プログラムは文の並びです。
• 文とソースファイルの行は通常 1:1 に対応しますが、中には複数の行をまとめて 1 つの文として扱うものもあります。
• 文は次のいずれかです。
  • 命令文 ･･･ Z80/R800 の命令
  • 疑似命令文 ･･･ 定数定義、`IF など yas80 が用意している命令
  • 空行（コメントのみの行も含む）

コメント

• ";" 以降行末まではコメントです。
• 改行記号と同じ扱いです。

式

• 文は式を含むことがあります。
• 式は各種リテラル、シンボルなどを必要により演算子で結合したもので評価すると"値"になります。
• yas80 では数値、文字列に他にレジスタ、フラグ、関数および配列も値であり、定数、変数、引数などに利用可能です。

数値リテラル

10 進数

• 0-9 を 1 文字以上続けたもの

16 進数

• 0x もしくは 0X の後に 0-9a-fA-F を 1 文字以上続けたもの
• $ の後に 0-9a-fA-F を 1 文字以上続けたもの
• 0-9 の後に 0-9a-fA-F を 1 文字以上続け、末尾に h もしくは H を付けたもの

8 進数

• 0o もしくは 0O の後に 0-7 を 1 文字以上続けたもの

2 進数

• 0b もしくは 0B の後に 0,1 を 1 文字以上続けたもの
• % の後に 0,1 を 1 文字以上続けたもの

_ 区切り

• 数値リテラルに "_" を含むことができます。
• ただしプレフィックス($, %)の直後には含められません。

num.asm:
    1       04d2(1234)                          const d1 = 1234
    2       04d2(1234)                          const d2 = 1_234
    3       1234(4660)                          const h1 = $1234
    4       1234(4660)                          const h2 = 0x12_34
    5       1234(4660)                          const h3 = 1234h
    6       00ff(255)                           const o1 = 0o377
    7       000f(15)                            const b1 = 0b1111
    8       00aa(170)                           const b2 = %1010_1010

文字列リテラル

• 二重引用符(") もしくは一重引用符(')で囲まれた文字列です。
• " で囲む場合、文字列中に " を含めるにはエスケープします(\")。' で囲む場合はエスケープ不要です。
• ' で囲む場合、文字列中に ' を含めるにはエスケープします(\')。" で囲む場合はエスケープ不要です。
• 利用可能なエスケープ文字は次表のとおりです。
• 次表に記載以外の文字をエスケープした場合、\ を含めそのまま文字列リテラルとします。
• 日本語を記載した場合、Shift_JIS コードの文字列リテラルとします。

str.asm
    1  0000 6d 65 73 73 61 67 65     [  ]       db "message"
    2  0007 22                       [  ]       db '"'
    3  0008 27                       [  ]       db "'"
    4  0009 22 27 5c 07 08 09 0b 0c  [  ]       db "\"'\\\a\b\t\v\f\n\r"
       0011 0a 0d                    [  ]
    5  0013 82 a0 82 a2 82 a4        [  ]       db "あいう"
    6  0019 5c 78 5c 79 5c 7a        [  ]       db "\x\y\z"

文字列リテラルの結合

• 連続する文字リテラルは結合され、1 つの 文字リテラルとして扱います。
• 継続行を使用し、複数行に渡る文字列リテラルを定義することも可能です。

; db "hello, world!" 
db "hello, " "world" "!" 

; charmap cmap, '{"あ":[65]}'
charmap cmap, '{' \      
  '"あ":[65]' \
  '}'                    
db cmap("あ")            ;

真偽値リテラル

• 真偽値リテラルはありません。
• IF/ELIF 等で論理値が必要な場合は次のように真偽を判定します。
• 比較演算、論理演算の結果は真の場合 1、偽の場合 0 となります。

レジスタ・フラグリテラル

キャリーフラグについて

• yas80 では C をレジスタリテラル、CY をフラグリテラルとして定義しています。
  
• 条件ジャンプ命令など、フラグが必要な場合は C を CY に置き換えて評価するため、どちらも利用可能です。

carry.asm:
    1  0000 d8   [11]   ret c  ; C はレジスタだが CY に置き換えて評価
    2  0001 d8   [11]   ret cy ; CY を指定することも可

• ただし ＝＝, != 演算子で同値判定する場合は異なる値となるので、マクロの引数で同値判定する場合などは注意してください。

配列リテラル

• [, ] で式を囲んだもの
• 配列リテラルに [数値式] を付与することで対応する位置の配列要素を参照することができます。
• 配列リテラルの要素は参照のみ可能で値を更新することはできません。
• MACRO呼出し、REPT展開の引数に指定することもできます。

array.asm:
    1                                           const msgs = ["one", "two", "three"]
    2
    3                                           rept msgs
    4                                             db $v
    5                                           endr
    5                                         + $COUNT = 3(0x3)
    5                                         + $I = 0(0x0)
    5                                         + $V = "one"
    5  0000 6f 6e 65                 [  ]     +   db $v
    5                                         + $COUNT = 3(0x3)
    5                                         + $I = 1(0x1)
    5                                         + $V = "two"
    5  0003 74 77 6f                 [  ]     +   db $v
    5                                         + $COUNT = 3(0x3)
    5                                         + $I = 2(0x2)
    5                                         + $V = "three"
    5  0006 74 68 72 65 65           [  ]     +   db $v
    6
    7  000b 74 77 6f                 [  ]       message db msgs[1]  ; "two"

演算子

• 数値演算子
  • 四則演算 + - * /
  • 剰余演算 %  ※2 進数リテラルとの誤認識を避けるため%の直後は空白文字としてください
  • ビット演算 & | ^ ~ << >>
• 比較演算子 == != < <= => >
• 論理演算子 || && !（論理否定）
• 文字列結合 +
• シンボル結合演算子 ##

演算子の優先順位

シンボル結合演算子

• シンボルと数値もしくは文字列を結合し、別のユーザ定義名とするものです。
• 左辺がシンボル、右辺が数値もしくは文字列です。
• シンボル結合演算子は結合しません。
• 結合対象のシンボルは、既定義、未定義のどちらでも利用できます。

concat.lst

concat.asm
    1  0000 01                       [  ]       data ## 1                db 1
    2  0001 02                       [  ]       data ## "_2"             db 2
    3  0002 03                       [  ]       data ## $fmt("_%03d", 3) db 3

concat.sym

0000 DATA1
0001 DATA_2
0002 DATA_003

名前

• yas80 で扱う"名前"として英字もしくは "_" で始まり、英数字もしくは"_"を続けたものと、"$"で始まるシステムで定義した名前があります。
• 構文解析の工程で全て大文字に変換するため、大文字、小文字の違いは区別されません。

• 名前のうち、ラベル、定数名、変数名は"シンボル"とし式で利用可能です。
• PROC名、関数名も式で利用可能です。

ユーザ定義名とスコープ

PROC ローカルラベル

PROCローカルラベルを定義する場合、ラベル文、命令の前のラベルには ":" が必要です。

sub proc
  or a
  jr z, .ret
  ; do something
.ret:  ; : が必要
  ret
endp

システム変数

yas80 では次のシステム変数を定義しています。 システム変数は参照のみ可能です。書込みはできません。

組み込み関数

yas80 の組み込み関数を次表に示します。 関数名が 2 つ記載されているものはエイリアスで、違いはありません。

組み込み関数使用例

sample.lst

sample.asm:
    1  0000 01 01 00   [  ]    dd 1, $w(1)                     ; db 1 \ dw 1
    2  0003 30 30 31   [  ]    db $fmt("%03d", 1)              ; db "001"
    3  0006 00         [ 4]    data ## $fmt("%03d", 12): nop   ; data012: nop

sample.sym

0006 DATA012