basic/school/MANIFEST.md · 6845 字节 · 下载原文
# BASIC 外部老程序语料(10 个)
**来源**:全部取自 [Rosetta Code](https://rosettacode.org/) 各任务页 **BASIC 系列段落**里的
**一个 `<syntaxhighlight>` 代码块**(QBasic / GW-BASIC / FreeBASIC 方言段,或 `=={{header|BASIC}}==`
下**非方言标题**的小节,如 "Iterative" / "Using a Subroutine")。
每份文件 = 该代码块**逐字**内容(只做 `strip()` + 末尾补一个换行,未改一个字符)。
**许可**:Rosetta Code 全站内容按 **GNU Free Documentation License 1.2** 发布
(见 <https://rosettacode.org/wiki/Rosetta_Code:Copyrights>);逐条许可未在页面内单独标注。
**抓取日期**:2026-10-14。
**机械口径**:`python3 scripts/compat-external-lint.py --dir <本目录>` ⇒ **10/10 通过**(0 处违规)。
**编译判据**:`bash scripts/vml-compat-external.sh basic`(`vmlcli <文件> --lang basic --timeout 25`),
判据**只有"编不编得过"**一条(运行结果不算这一批的判据)。
⚠ 本批**全部为纯文本程序**(无 `POKE`/`PEEK`/`DEF SEG`/`INP`/`OUT`/`INTERRUPT`/图形语句,无 `INPUT`),
即"人挑的那两条"(经典 / 自包含)与三条硬口径都满足。
## 结果:收到 10 / 通过 6 / 失败 4
| 文件名 | 来源 URL | 许可 | 行数 | 编译 | 第一条错误(原文) |
|---|---|---|---|---|---|
| `factorial.bas` | <https://rosettacode.org/wiki/Factorial> | Rosetta Code / GFDL 1.2 | 8 | ✅ | — |
| `sieve_of_eratosthenes.bas` | <https://rosettacode.org/wiki/Sieve_of_Eratosthenes> | Rosetta Code / GFDL 1.2 | 19 | ✅ | — |
| `roman_numerals.bas` | <https://rosettacode.org/wiki/Roman_numerals/Encode> | Rosetta Code / GFDL 1.2 | 25 | ✅ | — |
| `bubble_sort.bas` | <https://rosettacode.org/wiki/Sorting_algorithms/Bubble_sort> | Rosetta Code / GFDL 1.2 | 24 | ✅ | — |
| `towers_of_hanoi.bas` | <https://rosettacode.org/wiki/Towers_of_Hanoi> | Rosetta Code / GFDL 1.2 | 9 | ✅ | — |
| `100_doors.bas` | <https://rosettacode.org/wiki/100_doors> | Rosetta Code / GFDL 1.2 | 16 | ✅ | — |
| `fibonacci.bas` | <https://rosettacode.org/wiki/Fibonacci_sequence> | Rosetta Code / GFDL 1.2 | 38 | ❌ | `<input>:3: error: 未定义的函数 'func_long'(引用 2 次)` |
| `insertion_sort.bas` | <https://rosettacode.org/wiki/Sorting_algorithms/Insertion_sort> | Rosetta Code / GFDL 1.2 | 30 | ❌ | `<input>:14: error: 未定义的函数 'func_ubound'(引用 1 次)` |
| `n_queens.bas` | <https://rosettacode.org/wiki/N-queens_problem> | Rosetta Code / GFDL 1.2 | 56 | ❌ | `<input>:3: error: 未定义的函数 'func_ulong'(引用 2 次)` |
| `reverse_a_string.bas` | <https://rosettacode.org/wiki/Reverse_a_string> | Rosetta Code / GFDL 1.2 | 14 | ❌ | `<input>:4: error: 未定义的函数 'func_s'(引用 2 次)` |
方言分布(按 Rosetta Code 页面上的段落归属):generic BASIC 3(`factorial` `insertion_sort` `towers_of_hanoi`)·
QBasic 4(`sieve_of_eratosthenes` `roman_numerals` `fibonacci` `100_doors`)·
GW-BASIC 1(`bubble_sort`,行号式老程序)· FreeBASIC 2(`reverse_a_string` `n_queens`)。
## 失败原因归类(每条都用**最小探针**复现过,不是读代码推的)
| 根因 | 受影响文件 | 最小复现 | 结论 |
|---|---|---|---|
| **`UBOUND` / `LBOUND` 在 `SUB`/`FUNCTION` 体内不被认作内置函数** | `insertion_sort` `fibonacci` | `SUB f ()`⏎` DIM a(10) AS INTEGER`⏎` PRINT UBOUND(a)`⏎`END SUB` ⇒ `未定义的函数 'func_ubound'` | **顶层** `PRINT UBOUND(a)` / `PRINT LBOUND(a)` 编得过(`LEN` 在过程内也正常)⇒ 只有**过程体内**这一支没接上内置表:它把 `UBOUND` 当成**用户函数**去发 `func_ubound`,链接期报未定义。**2 个失败文件都因此挂**(本批最常见的失败原因)。 |
| **`REDIM <数组>(...) AS <浮点/长整型>` 的 `AS` 子句被漏掉** | `fibonacci` | `REDIM a(1) AS LONG` ⇒ `未定义的函数 'func_long'` | 同样写法 `REDIM a(1) AS INTEGER` / `AS STRING` ✅,而 `AS LONG` / `AS SINGLE` / `AS DOUBLE` ❌;`DIM a(1) AS LONG` ✅、`REDIM SHARED a(1)`(不带 `AS`)✅ ⇒ **只此一条语句的 `AS` 类型子句收得不全**,类型名被当成标识符 → `func_long`。 |
| **语句以 `name[...]`(方括号下标)开头时整条赋值被误解析** | `reverse_a_string` | `DIM a(3) AS INTEGER`⏎`DIM b(3) AS INTEGER`⏎`a[0] = b` ⇒ `未定义的函数 'func_b'` | 触发条件是 **LHS 用 `[ ]` 下标**且 **RHS 含标识符**:`a[0] = 5` ✅、`PRINT a[0]` ✅、`a(0) = b(1)` ✅,而 `a[0] = b` / `a[0] = b + 1` / `a[0] = 1 + b(1)` / `b[1] = a[0]` 全 ❌(RHS 那个标识符被登记成**被调函数**)。源码形态 `r[i] = s[length - 1 - i]` 正是这一个。 |
| **VB 风格 `DIM SHARED AS <类型> <名>`(类型在名前)不认** | `n_queens` | `Dim Shared As Integer count` ⇒ `未定义的函数 'func_count'`;`DIM SHARED AS INTEGER a` ⇒ `未定义的函数 'func_a'` | `DIM x AS INTEGER`(类型在后)✅、`DIM SHARED a(1) AS LONG` ✅ ⇒ 只有**类型在变量名之前**的 VB 写法没解析,变量名被当成标识符 → `func_<名>`。`n_queens.bas` 首行 `Dim Shared As ULong count, c()` 即此(该文件另有 `OrElse` / `Continue For, For` / `Print Using` / `Sleep` / `Inkey` 等 FreeBASIC 现代写法,属另一类"未实现语法",此处未单独展开)。 |
## 对照:同一门的"能编过"形态(作为对照,非本批语料)
| 探针 | 结果 |
|---|---|
| `PRINT UBOUND(a)` / `PRINT LBOUND(a)`(**顶层**) | ✅ 编过 |
| `DIM a(1) AS LONG` / `REDIM a(1) AS INTEGER` / `REDIM SHARED a(1)` | ✅ 编过 |
| `DIM s AS STRING : r[0] = "x"` / `PRINT s[2]` / `r = s[2]` | ✅ 编过 |
| `SELECT CASE` / `DECLARE FUNCTION f& (n AS INTEGER)` / `FUNCTION f& (...)` | ✅ 编过 |
| `FOR n=1 TO 3 : IF n THEN PRINT USING "####"; n; : NEXT n` | ✅ 编过 |
⇒ 缺口是**具体的语法形态**(过程体内的 `UBOUND`/`LBOUND` / `REDIM … AS 类型` / `name[…] =` 语句 / VB 的 `DIM SHARED AS 类型 名`),
不是"BASIC 前端整体不可用"(10 个里 6 个整程序编过了,含递归、数组、`SUB`、`GOSUB`、`DATA`/`READ`、`SELECT CASE`)。
## 附注
- 语料**不进仓库**(许可参差,见本目录上级 `README.md` 与 `.gitignore` 第 221 行起的说明):
`/third_party/vml/compat-corpus/external/*` 整目录被忽略,**MANIFEST.md 与语料一样只在本地**;
要收进仓库时按本表逐条挑许可明确的(这一步要人来定)。
- 本批只判"编不编得过";**运行期结果对不对不在本批判据内**(前端规格与 `vml-basic-probe` 用例另有判据)。
- 10 份均不含 `INPUT`,故不存在"运行时等人输入"的干扰(`vmlcli` 会照常编译并直接跑到结束)。