Python/C API 參考手冊
*********************

對於想要編寫擴充模組或是嵌入 Python 的 C 和 C++ 程式設計師們，這份手冊
記錄了可使用的 API（應用程式介面）。在擴充和嵌入 Python 直譯器中也有相
關的內容，它描述了編寫擴充的一般原則，但並沒有詳細說明 API 函式。

* 簡介

  * 代码标准

  * 包含文件

  * 有用的宏

  * 对象、类型和引用计数

  * 例外

  * 嵌入式Python

  * 调试构建

* C API 的稳定性

  * 应用程序二进制接口的稳定版

  * 平台的考虑

  * 受限 API 的内容

* 极高层级 API

* 參照計數

* 例外處理

  * 打印和清理

  * 抛出异常

  * 发出警告

  * 查询错误指示器

  * 信号处理

  * 例外類別

  * 例外物件

  * Unicode 异常对象

  * 递归控制

  * 标准异常

  * 标准警告类别

* 工具

  * 作業系統工具

  * 系統函式

  * 行程（Process）控制

  * 匯入模組

  * 数据 marshal 操作支持

  * 解析参数并构建值变量

  * 字串轉換與格式化

  * 反射

  * 编解码器注册与支持功能

* 抽象物件層 (Abstract Objects Layer)

  * 对象协议

  * 呼叫協定 (Call Protocol)

  * 数字协议

  * 序列协议

  * 映射协议

  * 迭代器协议

  * 緩衝協定 (Buffer Protocol)

  * 舊式緩衝協定 (Buffer Protocol)

* 具体的对象层

  * 基礎物件

  * 數值物件

  * 序列物件

  * 容器物件

  * 函式物件

  * 其他物件

* 初始化，终结和线程

  * 在Python初始化之前

  * 全局配置变量

  * 初始化和最终化解释器

  * 进程级参数

  * 线程状态和全局解释器锁

  * 子解释器支持

  * 异步通知

  * 分析和跟踪

  * 高级调试器支持

  * 线程本地存储支持

* Python初始化配置

  * 範例

  * PyWideStringList

  * PyStatus

  * PyPreConfig

  * 使用 PyPreConfig 预初始化 Python

  * PyConfig

  * 使用 PyConfig 初始化

  * 隔离配置

  * Python 配置

  * Python 路径配置

  * Py_RunMain()

  * Py_GetArgcArgv()

  * 多阶段初始化私有暂定 API

* 記憶體管理

  * 總覽

  * 分配器域

  * 原始内存接口

  * 内存接口

  * 对象分配器

  * 默认内存分配器

  * 自定义内存分配器

  * Python 内存分配器的调试钩子

  * pymalloc 分配器

  * tracemalloc C API

  * 範例

* 对象实现支持

  * 在堆上分配对象

  * 通用物件結構

  * 类型对象

  * Number Object Structures

  * Mapping Object Structures

  * Sequence Object Structures

  * Buffer Object Structures

  * Async Object Structures

  * Slot Type typedefs

  * 範例

  * 使对象类型支持循环垃圾回收

* API 和 ABI 版本管理
