友情提示:此为高阶主题,初级码农请绕行。
2. 自定义扩展类型:教程
Python 允许编写 C 扩展模块定义可以从 Python 代码中操纵的新类型,这很像内置的
str
和
list
类型。所有扩展类型的代码都遵循一个模式,但是在您开始之前,您需要了解一些细节。这份文件是对这个主题介绍。
2.1. 基础
CPython 运行时将所有 Python 对象都视为类型
PyObject*
的变量,即所有 Python 对象的"基础类型"。
PyObject
结构体本身包含了对象的 reference count 和对象的"类型对象"。类型对象确定解释器需要调用哪些 (C) 函数,例如一个属性查询一个对象,一个方法调用,或者与另一个对象相乘。这些 C 函数被称为“类型方法”。所以,如果你想要定义新的扩展类型,需要创建新的类型对象。这类事情只能用例子解释,这里用一个最小化但完整的的模块,定义了新的类型叫做
Custom
在C扩展模块
custom
里。注解 这里展示的方法是定义
static 扩展类型的传统方法。可以适合大部分用途。C API也可以定义在堆上分配的扩展类型,使用
PyType_FromSpec()
函数,但不在本入门里讨论。
#define PY_SSIZE_T_CLEAN#include typedef struct {
PyObject_HEAD/* Type-specific fields go here. */
} CustomObject;static PyTypeObject CustomType = {
PyVarObject_HEAD_INIT(NULL, 0)
.tp_name = "custom.Custom",
.tp_doc = "Custom objects",
.tp_basicsize = sizeof(CustomObject),
.tp_itemsize = 0,
.tp_flags = Py_TPFLAGS_DEFAULT,
.tp_new = PyType_GenericNew,
};static PyModuleDef custommodule = {
PyModuleDef_HEAD_INIT,
.m_name = "custom",
.m_doc = "Example module that creates an extension type.",
.m_size = -1,
};
PyMODI