第26章:API 参考
状态
这份参考正在编写中。教程章节已经完整,并且仍然是“这个库应该怎么用”的权威说明; 这一节会逐步长成它们旁边的查找层。
目标不是把每个声明都倒出来,而是给出“任务到类型和函数”的映射, 并把所有权、缓冲行为和错误契约写清楚。
参考将如何组织
| 领域 | 覆盖内容 | 教程入口 |
|---|---|---|
| 核心 I/O | print、scan、transmit、manipulator、
格式化与扫描定制 |
第11章:I/O |
| 设备 | 原生文件、带缓冲文件、管道、socket、控制台和内存设备 | 第11章:I/O |
| 文件系统与操作系统层 | POSIX、Win32、NT、Wine、目录、临时文件和 mmap | 第11章:I/O |
| 异步 I/O | task、observer、scheduler、accept/connect、async scan/print/transmit | 第23章:协程 |
| 容器 | string、vector、B 树、哈希容器和视图 |
第4章 和 第9章 |
| 编译期与反射 | type traits、concept、反射工具与代码生成 | 第24章:反射 |
在参考完成之前
使用介绍该特性的那一章。每一页都会说明头文件、类型、操作和失败契约, 章节目录是找到正确页面的最快方式:
- 第11章:I/O — 设备、操作、格式化、文件与进程。
- 第23章:协程 — 异步模型。
- 第24章:反射 — 编译期反射。
- 第20章:Freestanding — 没有操作系统时哪些东西会变。
如果这里缺少某个声明,不要根据名字猜。先读介绍它的那一章; 参考条目写好后会链接回去。
目录
要点
- 教程章节解释意图;API 参考提供查找。
- 每个参考条目都必须写清所有权、缓冲行为和错误契约。
- 从介绍该特性的章节开始,而不是从声明列表开始。
- 这一节还在建设中;链接到的章节今天就可以使用。