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

本手册描述了希望编写扩展模块并将 Python 解释器嵌入其应用程序中的 C 和
C++ 程序员可用的 API。同时可以参阅 扩展和嵌入 Python 解释器 ，其中描述
了扩展编写的一般原则，但没有详细描述 API 函数。

* 簡介

  * 代码标准

  * 包含文件

  * 有用的宏

  * 对象、类型和引用计数

  * 异常

  * 嵌入式Python

  * 调试构建

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

* 极高层级

* 參照計數

* 例外處理

  * 打印和清理

  * 抛出异常

  * 警告

  * 查询错误指示器

  * 信号处理

  * 异常类

  * 异常对象

  * Unicode 异常对象

  * 递归控制

  * 标准异常

  * 标准警告类别

* 工具

  * 作業系統工具

  * 系統函式

  * 行程（Process）控制

  * 匯入模組

  * 数据 marshal 操作支持

  * 解析参数并构建值变量

  * 字串轉換與格式化

  * 反射

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

* 抽象物件層

  * 对象协议

  * 数字协议

  * 序列协议

  * 映射协议

  * 迭代器协议

  * 缓冲协议

  * 旧缓冲协议

* 具体的对象层

  * 基本对象

  * 数值对象

  * 序列对象

  * 容器对象

  * 函式物件

  * 其他对象

* 初始化，终结和线程

  * 在Python初始化之前

  * 全局配置变量

  * Initializing and finalizing the interpreter

  * Process-wide parameters

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

  * 子解释器支持

  * 异步通知

  * 分析和跟踪

  * 高级调试器支持

  * 线程本地存储支持

* Python初始化配置

  * PyWideStringList

  * PyStatus

  * PyPreConfig

  * Preinitialization with PyPreConfig

  * PyConfig

  * Initialization with PyConfig

  * Isolated Configuration

  * Python Configuration

  * 路径配置

  * Py_RunMain()

  * Multi-Phase Initialization Private Provisional API

* 記憶體管理

  * 總覽

  * 原始内存接口

  * 内存接口

  * 对象分配器

  * 默认内存分配器

  * 自定义内存分配器

  * pymalloc 分配器

  * tracemalloc C API

  * 例子

* 对象实现支持

  * 在堆上分配对象

  * 通用物件結構

  * 类型对象

  * Number Object Structures

  * Mapping Object Structures

  * Sequence Object Structures

  * Buffer Object Structures

  * Async Object Structures

  * Slot Type typedefs

  * 例子

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

* API 和 ABI 版本管理
