扩展和嵌入 Python 解释器

Release:3.2 Date:October 09, 2017

这份文档描述了如何使用 C 或 C++ 为 Python 解释器写扩展模块. 这些模块不仅可以定义新的函数, 还可以是新的对象类型以及它们的方法. 这份文档也定义如何嵌入 Python 解释器到另一个应用里, 而作为一个扩展语言. 最后, 它告诉了如何编译和链接扩展模块以使得它们可以动态地 (在运行时刻) 载入到解释器里, 这需要底层的操作系统支持这个特性.

这份文档需要读者拥有 Python 的基础知识. 想得到这门语言的非正式介绍, 参阅 Python 入门教程. Python 语言参考 给出了这门语言的一个更为正式的定义. Python 标准库 描述了已有的对象类型, 函数和模块 (内建的和使用 Python 写的), 它们给了这门语言宽泛的使用范围.

想要整个 Python/C API 的详细描述, 参阅单独的 Python/C API 参考手册.

• 1. Extending Python with C or C++
  • 1.1. A Simple Example
  • 1.2. Intermezzo: Errors and Exceptions
  • 1.3. Back to the Example
  • 1.4. The Module’s Method Table and Initialization Function
  • 1.5. Compilation and Linkage
  • 1.6. Calling Python Functions from C
  • 1.7. Extracting Parameters in Extension Functions
  • 1.8. Keyword Parameters for Extension Functions
  • 1.9. Building Arbitrary Values
  • 1.10. Reference Counts
  • 1.11. Writing Extensions in C++
  • 1.12. Providing a C API for an Extension Module
• 2. Defining New Types
  • 2.1. The Basics
  • 2.2. Type Methods
• 3. Building C and C++ Extensions with distutils
  • 3.1. Distributing your extension modules
• 4. Building C and C++ Extensions on Windows
  • 4.1. A Cookbook Approach
  • 4.2. Differences Between Unix and Windows
  • 4.3. Using DLLs in Practice
• 5. Embedding Python in Another Application
  • 5.1. Very High Level Embedding
  • 5.2. Beyond Very High Level Embedding: An overview
  • 5.3. Pure Embedding
  • 5.4. Extending Embedded Python
  • 5.5. Embedding Python in C++
  • 5.6. Linking Requirements