Files
2026-09-14 21:01:48 +08:00

59 lines
1.8 KiB
Markdown

# R8ASM
基于[ROT-8](https://gitea.starcells.ltd/starcells/ROT-8.git)的汇编语言\
和用于汇编汇编的汇编器类
## 作为语言的R8ASM
### 简介
rot8指令集是图灵完备的(假如tape无限长),因此就像大多数计算工具一样,rot8纸带"能表示任何计算任务" \
但这显然不是个令人满意的答案,理论上的成立从来不意味着工程上的可行,而实践表明用rot8本身编写处理复杂任务的程序在工程上确实几乎是不可行的 \
因此rot8也需要自己的汇编--r8asm,r8asm汇编的存在使得全加器纸带这类规模动辄成千上万条指令的复杂计算得以实现,且具有不错的复用能力,同时提供了抽象层以供[别的怪东西](https://gitea.starcells.ltd/starcells/R8VeritasCC)发挥威力 \
r8asm的语法很大程度上参考了nasm,因为这样在vscode里把.r8asm文件的语言模式绑定到nasm就可以享受语法高亮了,仅此而已
### 语法规范
见[SPEC](SPEC.md)
## 作为汇编器的R8ASM
### 简介
一个简单的汇编器实现,以class的形式封装 \
因为是重构,着急拿来干活,所以一些细节实现得比较糟糕 \
当然SPEC里提到的功能肯定是已实现的
### 标准宏
在[asm](asm)里提供了一些标准宏实现可供取用.标准宏命名规范,定义和功能同样见[SPEC](SPEC.md)
### 示例
``` CPP
// 若以库的形式调用r8asm
#include "r8asm/r8asm.hh"
#include <iostream>
int main() {
r8asm a;
size_t cell_size = 8;
a.import_file("asm/test.r8asm", cell_size);
std::cout << a.export_rot8();
return (0);
}
```
``` SH
# 若执行r8asm_test以汇编asm/test.r8asm
mkdir build
cd build
cmake ..
make -j$(nproc)
r8asm_test > test.rot8
```
### TODO
1. 各种Warning/Error提示
2. r8asm类的分割(架构调整)