# 教学例程（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` 里，供需要时追溯。