# dBase / xBase 外部老程序语料（10 个）

口径见上级 [`../README.md`](../README.md)。**判据只有一条：编不编得过。**

- 编译器：`vmlcli --lang dbase`（dBase/xBase 子集：`?`/`??` 输出、`IF`/`DO CASE`、`DO WHILE`/`FOR`、
  `STORE`/`=`/`:=`、`PROCEDURE`/`FUNCTION`、`LEN`/`UPPER`/`SUBSTR`/`STR`/`VAL`/`INT`/`MOD`/`ABS`/`ROUND`）
- 三条硬口径（`scripts/compat-external-lint.py --dir .`）：**10 个文件 0 违规**
- 结果：**收到 10 / 通过 1 / 失败 9**

## 语料来源

**Rosetta Code 没有 `Category:dBASE`**（该页 404；全站语言表里只有 **Clipper** 与 **Visual FoxPro**
两个 xBase 方言 Category）。因此本批语料的 xBase 主体取自 **Rosetta Code 各任务页的 `Clipper` 段落**
（Clipper 是本平台 dBase 前端最对口的方言 —— 经典 dBase III/IV 风格的 `.prg`），
另补 **2 个货真价实的 1991 年 MS-DOS dBase/Clipper 商业程序**（`david-padgett/msdos-dbase-apps-libs`，
MIT）以覆盖"表操作 / 菜单"这类真实老程序形态。

| 来源 | 许可 | 说明 |
|:--|:--|:--|
| <https://rosettacode.org/>（各任务页 `=={{header|Clipper}}==` 段） | Rosetta Code 全站内容按 **GNU Free Documentation License 1.2** 发布（<https://rosettacode.org/wiki/Rosetta_Code:Copyrights>）；逐条贡献者另有署名，页面内未单独标注 | 8 个 |
| <https://github.com/david-padgett/msdos-dbase-apps-libs>（branch `main`） | **MIT**（见该仓 README「License」节） | 2 个 |

抓取日期：2026-10-14。Rosetta Code 段落**逐字**取代码块（只 `strip()` + 补末尾换行）；
padgett 的两个文件**原样**（保留其 CRLF 行尾）。

## 清单

| 文件名 | 类别 | 来源 URL | 许可 | 行数 | 编译 | 第一条错误（原文） |
|:--|:--|:--|:--|--:|:--:|:--|
| `arithmetic_integer.prg` | 数值/算术 | <https://rosettacode.org/wiki/Arithmetic/Integer> | RC / GFDL 1.2 | 11 | ❌ | `arithmetic_integer.prg:5:4: error: 表达式中出现意外的 token（SLASH '/'）` |
| `arrays.prg` | 数组/集合 | <https://rosettacode.org/wiki/Arrays> | RC / GFDL 1.2 | 29 | ❌ | `arrays.prg:1:1: error: 表达式中出现意外的 token（SLASH '/'）` |
| `conditional_structures.prg` | 控制流 | <https://rosettacode.org/wiki/Conditional_structures> | RC / GFDL 1.2 | 16 | ❌ | `error: 未定义的函数 'SomeFunc1'（引用 2 次）` |
| `loops_downward_for.prg` | 控制流 | <https://rosettacode.org/wiki/Loops/Downward_for> | RC / GFDL 1.2 | 3 | ❌ | `loops_downward_for.prg:1:7: error: FOR 缺少 '='` |
| `man_or_boy.prg` | 递归/控制流 | <https://rosettacode.org/wiki/Man_or_boy_test> | RC / GFDL 1.2 | 25 | ❌ | `man_or_boy.prg:3:10: error: FOR 缺少 '='` |
| `price_fraction.prg` | 数值/查表 | <https://rosettacode.org/wiki/Price_fraction> | RC / GFDL 1.2 | 33 | ❌ | `price_fraction.prg:28:45: error: 表达式中出现意外的 token（NEWLINE ';'）` |
| `reverse_string.prg` | 字符串/文本 | <https://rosettacode.org/wiki/Reverse_a_string> | RC / GFDL 1.2 | 6 | ❌ | `reverse_string.prg:3:10: error: FOR 缺少 '='` |
| `string_comparison.prg` | 字符串/文本 | <https://rosettacode.org/wiki/String_comparison> | RC / GFDL 1.2 | 16 | ✅ | — |
| `estes.prg` | 经典应用（菜单/表操作） | <https://github.com/david-padgett/msdos-dbase-apps-libs/blob/main/ESTES/ESTES.PRG> | MIT | 90 | ❌ | `error: 未定义的函数 'ERROR_INIT'（引用 1 次）` |
| `locate_record.prg` | 表操作（记录查找） | <https://github.com/david-padgett/msdos-dbase-apps-libs/blob/main/LIB/PRG/CL2.PRG> | MIT | 71 | ❌ | `error: 未定义的函数 'asc'（引用 2 次）` |

> `estes.prg` 与 `locate_record.prg` 是**原样的 DOS 文件（CRLF 行尾）**，两者都**解析通过**
> （报错停在链接期）⇒ **本前端能吃 CRLF**，不是语料损坏。

## 失败根因（每条都用**最小探针**复现过，不是读代码猜的）

| 根因 | 受影响文件 | 最小复现（探针原文 → 实测报错） | 结论 |
|:--|:--|:--|:--|
| **`FOR i := …`（Clipper 惯用写法）** | `loops_downward_for` `man_or_boy` `reverse_string` | `FOR i := 1 TO 3` / `? i` / `NEXT` ⇒ `1:7: error: FOR 缺少 '='`；把 `:=` 换成 `=`（`FOR i = 1 TO 3`）**立刻编过** | `Parser` 的 `FOR` 分支**只收 `=`**，不认 `:=` —— 而 §2.2 已声明赋值支持 `:=`，是**同一个 `:=` 在两条语句里待遇不同**（本仓第二号形态）。这是本批**最常见**的编译失败原因。 |
| **链接期未定义函数** | `conditional_structures` `estes` `locate_record` | `? IIF(1 = 1, "y", "n")` ⇒ `未定义的函数 'IIF'`；`? ASC("a")` ⇒ `未定义的函数 'ASC'` | 前端把"非内置、非用户定义"的名字一律发 `CALL <原名>`（规格 §4 有意设计，靠链接器解析）。⇒ 老程序里**核心 dBase 内置函数不在本前端的 10 个内置表里**（逐个实测缺：`ASC` / `CHR` / `EOF` / `IIF` / `DATE` / `LTRIM` / `ALLTRIM`；已支持的 10 个 = `LEN`/`UPPER`/`LOWER`/`SUBSTR`/`STR`/`VAL`/`INT`/`MOD`/`ABS`/`ROUND`）就直接链接不过；`estes`/`conditional_structures` 则是**程序本身不完整**（被调过程在同目录别的 `.prg` 里 —— `estes` 调 `error_init`/`borders`/`menu` 等住 `PROC.PRG`/`CL1.PRG`/`CL5.PRG`，或语料只是片段）。 |
| **`//` 行内注释** | `arithmetic_integer` `arrays` | `// a comment` / `? "hi"` ⇒ `1:1: error: 表达式中出现意外的 token（SLASH '/'）`（**没有**行尾注释） | 词法器把 `//` 当**两个除号** ⇒ 注释被当表达式解析。规格 §1.1 只列了行首 `*`、行内 `&&`、行首 `NOTE` —— **`//` 是 Clipper 5 起的常见注释**，老程序里遍地都是。 |
| **`;` 续行符** | `price_fraction` | `x = 1 + ;` / `    2` / `? x` ⇒ `1:9: error: 表达式中出现意外的 token（NEWLINE ';'）` | `;` 被词法成**语句终结符**（规格 §2「`;` 也当换行」）⇒ Clipper 的**物理行续行**（行尾 `;`）在这里是"提前换行"，长表达式被拦腰截断。 |
| **`+=` 复合赋值** | `reverse_string`（叠加在 `FOR :=` 之上） | `s = "a"` / `s += "b"` ⇒ `2:4: error: 表达式中出现意外的 token（EQ '='）` | 只认 `=` / `:=`，不认 `+=`（`-=`/`*=…` 同理）。 |
| **数组字面量 `{…}`** | `arrays` `price_fraction`（叠加在 `//` / `;` 之上） | `x = {1,2,3}` ⇒ 词法把 `{` 当……（`arrays.prg` 首错停在 `//`，数组是**后一层**缺口） | 规格 §6 明确：**数组/下标不支持**（`[` 被当字符串引号）。⇒ 这是**已声明的**边界，不算回归，但它是老 dBase 程序的高频写法。 |

## 两个观察

1. **"这一门语言的老程序，第一个卡点是书写风格而不是能力"**：4 个失败里有 3 个（`FOR :=` ×3 加
   `//` 注释 ×2，去重后 5 个文件中的 4 个）栽在 **Clipper 5 的书写惯例**上（`:=` 赋值、`//` 注释、
   `;` 续行、`+=`），跟"能不能算"没关系 —— 说明**前端是按 dBase III 的语法写的，而语料是 Clipper 5 的**。
   两个方言的差异面（本批暴露出的）就这几条，补上收益最大。
2. **缺席判据这一批特别危险**：只有 1/10 通过 ⇒ 若把这 10 个文件挪走，"通过率 100%" 与
   "未取证" 在数字上分不开（本仓 E142）。所以上面每一条失败都配了**能单独跑的最小探针**，
   且 `estes.prg` / `locate_record.prg` 特意保留了原文件的 CRLF —— 好让"CRLF 是不是也被当失败"
   这个问题有正面答案（不是，解析过了）。

> 备注：本门**没有经典小游戏/模拟**可收 —— xBase 传统上被当练习语言的场景是**表格/报表/字符串处理**，
> 没有图形与随机模拟类的小程序传统（Rosetta Code 的 xBase 方言 Category 里同样一个游戏都没有）。
> 表格/报表那一类用 `estes.prg` + `locate_record.prg`（真实 1991 商业程序）覆盖。
