SCHOOL.md · 4364 字节 · 下载原文
# 教学例程(school/)—— 收录口径与实测结果
> 目的:用**别人写的程序**量「支持面」(`CLAUDE.md` 铁律:支持面不能用我们自己写的探针量)。
> 语料放 `Examples/<语言>/school/`,判据是「**能编过**」(`vmlcli <文件> --vml <tmp>`),
> 不是"跑出正确结果"—— 输出正确性另有各语言探针管。
## 一、口径
**只用标准库**(用户 2026-11-09 定:「非标准库,不需要支持」)。以下三类**不参与判据**,
分别落在各语言 `school/_unsupported/` 与 `school/_out_of_subset/`:
| 类别 | 判定 | 例子 |
|---|---|---|
| 第三方库 | `import` 的是 PyPI/npm/NuGet 上的包 | `PIL`、`openpyxl`、`pywin32`、`immlib`、`OpenGL`、`Crypto` |
| 平台不提供的标准库 | 网络 / 并发 / 嵌入式 DB / 调试器 | `socket`、`threading`、`sqlite3`、`doctest`、`urllib` |
| 超出当前语言子集 | 前端不支持的语法 | 闭包捕获、`*args`、类实例化、宏、LINQ、泛型结构体、Python 2 语法 |
⚠ 移出**不等于**"这些永远不做"—— 它们记在这份文件里,是**下一步的输入**,不是被删除的失败。
## 二、实测结果(2026-11-09)
**475 / 477 通过(99.6%)**,判据为 `scripts/vmlcli` 编译(真实通道,不是各门自带工装)。
| 语言 | 通过 | 语言 | 通过 | 语言 | 通过 | 语言 | 通过 |
|---|---|---|---|---|---|---|---|
| ada | 10/10 | c | 121/121 | cpp | 39/39 | csharp | 8/8 |
| d | 10/10 | dart | 10/10 | dbase | 6/6 | forth | 10/10 |
| fortran | 10/10 | go | 10/10 | java | 22/22 | javascript | 10/10 |
| kotlin | 10/10 | lua | 10/10 | objc | 10/10 | pascal | 41/41 |
| perl | 10/10 | php | 10/10 | python | 46/46 | r | 9/10 |
| ruby | 10/10 | rust | 7/7 | scheme | 10/10 | swift | 9/9 |
| typescript | 7/8 | basic | 10/10 | cobol | 10/10 | | |
## 三、已知缺口(4 个,未掩饰)
| 例程 | 缺什么 | 性质 |
|---|---|---|
| `typescript/class_demo.ts` | `p_sum` —— 类实例方法调用(JS 子集限制) | 子集限制 |
| `r/bulls_and_cows.r` | `strsplit` —— 该库函数未实现 | 库缺口 |
**已修**(v0.98.302):`objc/game_of_life.m` 的 `stdlib.h` 函数指针形参(`int (*compar)(…)`)
解析失败 —— 现在 ObjC 形参解析器能吃掉 `(*p)(…)` 这种声明符。
**已移出**:`java/013_clock.java` 依赖同目录的 `012_Display.java`(多文件工程),
单文件判据不适用,落在 `_out_of_subset/`。
## 四、语料来源
- **教材例程**:谭浩强《C 程序设计》、郑莉《C++语言程序设计》、翁恺《Java 程序设计》、
董付国《Python 程序设计》、Pascal 教学材料 —— 各自 `school/README.md` 记录了原始仓库与路径。
- **经典题目**:Rosetta Code / 经典教学实现(`compat-corpus/external/` 复制而来),
文件头的「来源 / Source」逐条注明。
## 五、版权与携带范围 / Copyright & Inclusion Notice
**中文**:本仓库随包携带的 `school/` 目录**只包含程序设计例程的源代码**,用于学习与模仿练习。
**不包含任何书籍内容** —— 没有教材正文、章节文字、扫描件、PDF/DOCX/EPUB,或任何形式的书籍影印。
每个语言的 `school/NOTICE.md` 都带同一份声明。
**English**: The `school/` directories shipped with this project contain **only program source
code** of programming exercises, provided for study and practice.
They contain **no book content whatsoever** — no textbook text, chapter prose, scanned pages,
PDF/DOCX/EPUB, or any form of reproduction of a book.
The same notice ships as `NOTICE.md` in every language's `school/` directory.
**只带例程代码,不带教材**:书籍正文有版权,而例程本来就是给人仿照练习的(用户 2026-11-09 定)。
- 本目录下**只有**:例程源码 + 来源说明(`README.md` / `MANIFEST.md` 记原始仓库与路径)。
- **没有**:教材正文、章节扫描件、PDF/DOCX/EPUB、讲解段落。
- 机械口径(复查用):`Examples/<语言>/school/` 下的文件只允许「源码扩展名 + `.md` 说明」,
实测最大源码 173 行 / 7.4KB(正常程序规模,不是书籍内容)。
- 原始仓库的许可信息保留在各语言 `README.md` / `MANIFEST.md` 里,供需要时追溯。