描述符对象

“描述符”是描述对象的某些属性的对象。它们存在于类型对象的字典中。

PyTypeObject PyProperty_Type
属于 稳定 ABI.

内建描述符类型的类型对象。

PyObject *PyDescr_NewGetSet(PyTypeObject *type, struct PyGetSetDef *getset)
返回值:新的引用。 属于 稳定 ABI.
PyObject *PyDescr_NewMember(PyTypeObject *type, struct PyMemberDef *meth)
返回值:新的引用。 属于 稳定 ABI.
PyTypeObject PyMemberDescr_Type
属于 稳定 ABI.

The type object for member descriptor objects created from PyMemberDef structures. These descriptors expose fields of a C struct as attributes on a type, and correspond to types.MemberDescriptorType objects in Python.

PyTypeObject PyGetSetDescr_Type
属于 稳定 ABI.

The type object for get/set descriptor objects created from PyGetSetDef structures. These descriptors implement attributes whose value is computed by C getter and setter functions, and are used for many built-in type attributes.

PyObject *PyDescr_NewMethod(PyTypeObject *type, struct PyMethodDef *meth)
返回值:新的引用。 属于 稳定 ABI.
PyTypeObject PyMethodDescr_Type
属于 稳定 ABI.

The type object for method descriptor objects created from PyMethodDef structures. These descriptors expose C functions as methods on a type, and correspond to types.MemberDescriptorType objects in Python.

PyObject *PyDescr_NewWrapper(PyTypeObject *type, struct wrapperbase *wrapper, void *wrapped)
返回值:新的引用。
PyTypeObject PyWrapperDescr_Type
属于 稳定 ABI.

The type object for wrapper descriptor objects created by PyDescr_NewWrapper() and PyWrapper_New(). Wrapper descriptors are used internally to expose special methods implemented via wrapper structures, and appear in Python as types.WrapperDescriptorType objects.

PyObject *PyDescr_NewClassMethod(PyTypeObject *type, PyMethodDef *method)
返回值:新的引用。 属于 稳定 ABI.
int PyDescr_IsData(PyObject *descr)

如果描述器对象 descr 描述的是一个数据属性则返回非零值,或者如果它描述的是一个方法则返回 0descr 必须是一个描述器对象;不会进行错误检测。

PyObject *PyWrapper_New(PyObject*, PyObject*)
返回值:新的引用。 属于 稳定 ABI.

内置描述器

PyTypeObject PySuper_Type
属于 稳定 ABI.

super 对象的类型对象。 它与 Python 层面的 super 是相同的对象。

PyTypeObject PyClassMethod_Type

类方法对象的类型。 它与 Python 层面的 classmethod 是相同的对象。

PyTypeObject PyClassMethodDescr_Type
属于 稳定 ABI.

The type object for C-level class method descriptor objects. This is the type of the descriptors created for classmethod() defined in C extension types, and is the same object as classmethod in Python.

PyObject *PyClassMethod_New(PyObject *callable)

新建一个包裹 callableclassmethod 对象。 callable 必须是一个可调用对象并且不可为 NULL

成功时,此函数将返回一个指向新类方法描述器的 strong reference。 失败时,此函数将返回 NULL 且不设置任何异常。

PyTypeObject PyStaticMethod_Type

静态方法对象的类型。 它与 Python 层面的 staticmethod 是相同的对象。

PyObject *PyStaticMethod_New(PyObject *callable)

新建一个包裹 callablestaticmethod 对象。 callable 必须是一个可调用对象并且不可为 NULL

成功时,此函数将返回一个指向新静态方法描述器的 strong reference。 失败时,此函数将返回 NULL 并设置一个异常。