扩展和嵌入 Python 解释器 — Python 文档

扩展和嵌入 Python 解释器

本文档描述了如何用 C 或 C++ 编写模块以使用新模块扩展 Python 解释器。 这些模块不仅可以定义新函数，还可以定义新的对象类型及其方法。 该文档还描述了如何将 Python 解释器嵌入到另一个应用程序中，以用作扩展语言。 最后，它展示了如何编译和链接扩展模块，以便它们可以（在运行时）动态加载到解释器中（如果底层操作系统支持此功能）。

本文档假定您了解 Python 的基本知识。 有关该语言的非正式介绍，请参阅 Python 教程 。 Python 语言参考 给出了更正式的语言定义。 Python 标准库 记录了现有的对象类型、函数和模块（内置和用 Python 编写），这些对象类型、函数和模块都为该语言提供了广泛的应用范围。

有关整个 Python/C API 的详细说明，请参阅单独的 Python/C API 参考手册 。

笔记

本指南仅涵盖作为此版本 CPython 的一部分提供的用于创建扩展的基本工具。 第三方工具可能会提供更简单的替代方案。 有关更多信息，请参阅 Python Packaging User Guide 中的 二进制扩展部分 。

• 1. 用 C 或 C++ 扩展 Python
  • 1.1. 一个简单的例子
  • 1.2. 间奏曲：错误和异常
  • 1.3. 回到例子
  • 1.4. 模块的方法表和初始化函数
  • 1.5. 编译链接
  • 1.6. 从 C 调用 Python 函数
  • 1.7. 在扩展函数中提取参数
  • 1.8. 扩展函数的关键字参数
  • 1.9. 建立任意值
  • 1.10. 引用计数
  • 1.11. 用 C++ 编写扩展
  • 1.12. 为扩展模块提供 C API
• 2. 定义新类型
  • 2.1. 基础知识
  • 2.2. 类型方法
• 3. 使用 distutils 构建 C 和 C++ 扩展
  • 3.1. 分发扩展模块
• 4. 在 Windows 上构建 C 和 C++ 扩展
  • 4.1. 食谱方法
  • 4.2. Unix 和 Windows 之间的差异
  • 4.3. 在实践中使用 DLL
• 5. 在另一个应用程序中嵌入 Python
  • 5.1. 非常高级的嵌入
  • 5.2. 超越非常高级的嵌入：概述
  • 5.3. 纯嵌入
  • 5.4. 扩展嵌入式 Python
  • 5.5. 在 C++ 中嵌入 Python
  • 5.6. 在类 Unix 系统下编译和链接