68、Python C API 扩展与嵌入指南：从基础到实践

Python C API 扩展与嵌入指南：从基础到实践

1. C 编码 Python 扩展模块概述

在使用 C 语言为 Python 编写扩展模块时，初始化函数 initx 通常具有以下结构：

void
initx(void)
{
    PyObject* thismod = Py_InitModule3("x", x_methods, "docstring for x");
    /* 可选：调用 PyModule_AddObject(thismod, "somename", someobj)
       以及其他 Python C API 调用，以完成模块对象 thismod 及其类型（如果有）和其他对象的准备工作。
    */
}

其中， x_methods 是一个 PyMethodDef 结构体数组，数组中的每个 PyMethodDef 结构体描述了模块 x 向导入它的 Python 代码提供的一个 C 函数。这些 C 函数通常有以下两种结构形式：

static PyObject*
func_with_named_arguments(PyObject* self, PyObject* args, PyObject* kwds)
{
    /* 省略：函数体，通过 Python C API 函数 PyArg_ParseTupleAndKeywords 访问参数，返回一个 PyO