类型对象 — Python 文档

来自菜鸟教程
Python/docs/3.7/c-api/type
跳转至:导航、​搜索

类型对象

type PyTypeObject
用于描述内置类型的对象的 C 结构。
PyObject *PyType_Type
这是类型对象的类型对象; 它与 Python 层中的 type 对象相同。
int PyType_Check(PyObject *o)
如果对象 o 是类型对象,包括从标准类型对象派生的类型实例,则返回 true。 在所有其他情况下返回 false。
int PyType_CheckExact(PyObject *o)
如果对象 o 是类型对象,但不是标准类型对象的子类型,则返回 true。 在所有其他情况下返回 false。
unsigned int PyType_ClearCache()
清除内部查找缓存。 返回当前版本标签。
unsigned long PyType_GetFlags(PyTypeObject *type)

返回 typetp_flags 成员。 该函数主要用于Py_LIMITED_API; 各个标志位保证在 Python 版本中是稳定的,但对 tp_flags 本身的访问不是受限 API 的一部分。

3.2 版中的新功能。

3.4 版更改: 返回类型现在是 unsigned long 而不是 long

void PyType_Modified(PyTypeObject *type)
使该类型及其所有子类型的内部查找缓存无效。 在对该类型的属性或基类进行任何手动修改后,必须调用此函数。
int PyType_HasFeature(PyTypeObject *o, int feature)
如果类型对象 o 设置了特征 feature,则返回 true。 类型特征由单个位标志表示。
int PyType_IS_GC(PyTypeObject *o)
如果类型对象包含对循环检测器的支持,则返回 true; 这将测试类型标志 Py_TPFLAGS_HAVE_GC
int PyType_IsSubtype(PyTypeObject *a, PyTypeObject *b)

如果 ab 的子类型,则返回 true。

这个函数只检查实际的子类型,这意味着 __subclasscheck__() 不会在 b 上调用。 调用 PyObject_IsSubclass() 进行与 issubclass() 相同的检查。

PyObject *PyType_GenericAlloc(PyTypeObject *type, Py_ssize_t nitems)
类型对象的 tp_alloc 槽的通用处理程序。 使用Python默认的内存分配机制来分配一个新实例,并将其所有内容初始化为NULL
PyObject *PyType_GenericNew(PyTypeObject *type, PyObject *args, PyObject *kwds)
类型对象的 tp_new 槽的通用处理程序。 使用类型的 tp_alloc 槽创建一个新实例。
int PyType_Ready(PyTypeObject *type)
完成一个类型对象。 这应该在所有类型对象上调用以完成它们的初始化。 该函数负责从类型的基类添加继承的槽。 成功返回 0,或返回 -1 并在错误时设置异常。
PyObject *PyType_FromSpec(PyType_Spec *spec)
从传递给函数的 spec 创建并返回堆类型对象。
PyObject *PyType_FromSpecWithBases(PyType_Spec *spec, PyObject *bases)

规范 创建并返回堆类型对象。 除此之外,创建的堆类型包含 bases 元组包含的所有类型作为基本类型。 这允许调用者引用其他堆类型作为基类型。

3.3 版中的新功能。

void *PyType_GetSlot(PyTypeObject *type, int slot)

返回存储在给定槽中的函数指针。 如果结果是 NULL,这表明插槽是 NULL,或者是使用无效参数调用了该函数。 调用者通常会将结果指针转换为适当的函数类型。

3.4 版中的新功能。