From 10b29000d6bec6a6a09f1f60587bce63f15cc6d7 Mon Sep 17 00:00:00 2001 From: StarCells Date: Wed, 16 Sep 2026 21:43:58 +0800 Subject: [PATCH] [tmp]202609162143 --- SPEC.md | 126 ++++++++++++++++++++++++++++++++++++++++++++----- asm/test.r8asm | 26 +--------- 2 files changed, 117 insertions(+), 35 deletions(-) diff --git a/SPEC.md b/SPEC.md index f472141..402ffe4 100644 --- a/SPEC.md +++ b/SPEC.md @@ -1,22 +1,42 @@ # R8ASM Specification -## 作用域规则 +## 词法规范 - 当调用宏时,宏体内会被视为新的作用域 \ - 在子作用域内,父作用域的符号是可读的, +### 特殊符号 -### TODO +#### 注释符号 -## 作为变量的编译期常量 +';'是r8asm的单行注释符号,从';'出现处到该行行末均会被视为注释内容 -由于rot8本身的限制,r8asm在运行时是几乎没有自由度可言的.内存中的数据难以参与控制流,r8asm自然也就无法实现灵活的各类取值运算 \ -因此,r8asm采用 +#### 位于token开头的指示符 -### TODO +r8asm用一些指示符区分具有特殊身份的token,它们通常位于token的首字符: -## 运算符优先级 +|符号|用途| +|---|---| +|.|标示内建指令| +|%|标示形参或汇编器指令| +|"|标示文件名| -r8asm的运算符优先级与nasm一致,具体来讲: +> "与其他指示符不同,会被划分为[单独的token](#token类型) \ +> 其出现在文件名左侧时为LPAREN,出现在右侧则为RPAREN + +#### 空白符号 + +在r8asm中,以下符号将被视为空白符号,参与token的切割: + +|名称|符号| +|---|---| +|空格|' '| +|制表符|\t| +|换行|\n| +|回车|\r| +|换页|\f| +|垂直制表符|\v| + +### 运算符与运算符优先级 + +r8asm采用部分nasm运算符,且优先级与nasm基本一致,具体来讲: |运算符|含义|优先级| |---|---|---| @@ -29,4 +49,88 @@ r8asm的运算符优先级与nasm一致,具体来讲: |^|按位异或|4| |\||按位或|5| -## 标准宏 +### token类型 + +r8asm将切割源码产生的token分类为: + +|类型|形式|说明| +|---|---|---| +|STRING|一般标识符或数字|宏名(声明宏时),变量名,数字等| +|OPERATOR|~ * / + - & ^ \||见[运算符与运算符优先级](#运算符与运算符优先级)| +|MACROCALL|位于行首的一般标识符|宏调用| +|ROT8|stp btp ror flb biz rnz inp out|rot-8指令| +|DIRECTIVE|行首的,开头为'%'的token|汇编器指令| +|PARAMETER|非行首的,开头为'%'的token|形式参数| +|BUILTIN|开头为'.'的token|内建指令| +|LPAREN/RPAREN|( )|表达式中的括号| +|LQUOTE/RQUOTE|"|文件名标识| +|ENDL|行末|这玩意好像没怎么用过啊| + +## 语法规范 + +### 程序结构 + +一份r8asm程序由若干行组成 \ +每行(若不为空行)由宏调用,指令,内建指令或rot-8指令开始,其后是$\geq0$个参数 \ +参数可以是形式参数,数字,表达式,字符串,变量名或文件 +> 仅含注释的行同样视为空行 + +### 指令 + +|形式|含义| +|---|---| +|%macro \|开始宏声明| +|%endmacro|结束宏声明| +|%rep \|开始重复声明| +|%endrep|结束重复声明| +|%include "\"|包含另一份r8asm文件| + +> r8asm也支持以和nasm相同的,%macro \ \的形式声明宏 \ +> 但\在这里没有任何实际影响,哪怕其值为🐸也不影响宏的正常声明和使用 + +### 内建指令 + +|形式|含义| +|---|---| +|.tp \|将dataptr移动至指定cell| +|.anchor \|在本作用域内,标记dataptr指向的cell| +|.xor \|对dataptr指向的cell进行xor \运算| +|.loop/.endloop|通过消耗dataptr所指cell的下一个cell中,从LSB开始的,连续的'1'进行循环| +|.var \ \|在本作用域内,创建一个值为\,变量名为\的变量,或将变量\的值改为\| + +### 表达式 + +和运算符有关的内容见[运算符与运算符优先级](#运算符与运算符优先级) \ +支持括号 \ +支持常量,变量或形参 + +### ROT-8 + +与原始rot-8指令相同,r8asm中的rot-8指令不接受参数 + +### 语义规范 + +#### dataptr的守恒 + +rot-8并没有提供对随机读写的支持,因此r8asm汇编器需要自行维护dataptr以随时在编译期计算跳转偏移量 \ +仅当每个macro与每段biz/rnz中的stp与btp数目相匹配时,这样的计算才是可行的 +> 在宏入口处.anchor,在出口处.tp是一种简单有效的办法,虽然有时候可能不太高效 + +#### Unit与Cell + +在r8asm中,cell的地址从0开始 \ +地址为$n+1$的cell是地址为$n$的cell的辅助cell,二者合称为一个Unit + +#### 作用域 + +TODO + +#### 宏展开 + +TODO + +### 标准宏规范 + +#### 标准宏命名前缀 + +TODO \ No newline at end of file diff --git a/asm/test.r8asm b/asm/test.r8asm index 4ae6181..ac823bf 100644 --- a/asm/test.r8asm +++ b/asm/test.r8asm @@ -15,9 +15,9 @@ .tp A .xor 127 .tp B -.xor 11 +.xor (~126)+1 .tp Ci -.xor 1 +.xor 0 raw_add A B Ci S Co tmp @@ -26,25 +26,3 @@ output B output Ci output S output Co - -raw_and A B S tmp -output A -output B -output S - -raw_or A B S tmp -output A -output B -output S - -raw_xor A B S tmp -output A -output B -output S - - -raw_inc A Ci S Co tmp -output A -output Ci -output S -output Co \ No newline at end of file