描述器对象
**********

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

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

   根据 "PyGetSetDef" 结构体 *getset* 为扩展类型 *type* 创建一个新的
   get-set 描述器。

   get-set 描述器将暴露由 C getter 和 setter 函数实现的属性而不是直接
   存储在实例中。 这与为 "tp_getset" 中条目创建的描述器种类相同，它将
   作为一个 "types.GetSetDescriptorType" 对象出现在 Python 中。

   成功时，返回指向该描述符的 *强引用*。 失败时返回 "NULL" 并设置异常
   。

PyObject *PyDescr_NewMember(PyTypeObject *type, struct PyMemberDef *member)
    *返回值：新的引用。** 属于 稳定 ABI.*

   根据 "PyMemberDef" 结构体 *member* 为扩展类型 *type* 创建一个新的成
   员描述符。

   成员描述符将类型 C 结构体中的字段公开为 Python 属性。 这与为
   "tp_members" 中的条目创建的描述符属于同一种类，并且在 Python 中显示
   为 "types.MemberDescriptorType" 对象。

   成功时，返回指向该描述符的 *强引用*。 失败时返回 "NULL" 并设置异常
   。

PyTypeObject PyMemberDescr_Type
    * 属于 稳定 ABI.*

   基于 "PyMemberDef" 结构体创建的成员描述器对象的类型对象。这种描述器
   将 C 结构的字段暴露为类型的属性，对应 Python 中的
   "types.MemberDescriptorType" 对象。

PyTypeObject PyGetSetDescr_Type
    * 属于 稳定 ABI.*

   根据 "PyGetSetDef" 结构体创建的 get/set 描述符对象的类型对象。 这些
   描述符实现了其值由 C getter 和 setter 函数计算的属性，并用于许多内
   置类型属性。 它们对应于 Python 中的 "types.GetSetDescriptorType" 对
   象。

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

   根据 "PyMethodDef" 结构体 *meth* 为扩展类型 *type* 创建一个新的方法
   描述符。

   方法描述符将 C 函数公开为类型上的方法。 这与为 "tp_methods" 中的条
   目创建的描述符属于同一种类，并且在 Python 中显示为
   "types.MethodDescriptorType" 对象。

   成功时，返回指向该描述符的 *强引用*。 失败时返回 "NULL" 并设置异常
   。

PyTypeObject PyMethodDescr_Type
    * 属于 稳定 ABI.*

   根据 "PyMethodDef" 结构体创建的方法描述符对象的类型对象。 这些描述
   符将 C 函数公开为类型上的方法，并对应于 Python 中的
   "types.MethodDescriptorType" 对象。

PyTypeObject PyWrapperDescr_Type
    * 属于 稳定 ABI.*

   由 "PyDescr_NewWrapper()" 和 "PyWrapper_New()" 创建的包装器描述器对
   象的类型对象。

   Wrapper descriptors are used internally to expose special methods
   such as "__repr__" or "__add__", which are implemented by type
   slots. The type is exposed in Python as
   "types.WrapperDescriptorType".

PyObject *PyDescr_NewWrapper(PyTypeObject *type, struct wrapperbase *base, void *wrapped)
    *返回值：新的引用。*

   Create a new wrapper descriptor of type "PyWrapperDescr_Type".

   This function is meant for internal use only; it and related API
   ("struct wrapperbase" and the "PyWrapperFlag_KEYWORDS" flag) are
   exposed publicly for backwards compatibility reasons.

   请参阅 "PyCMethod_New()" 了解如何包装 C 函数。

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

   根据 "PyMethodDef" 结构体 *method* 为扩展类型 *type* 创建一个新的类
   方法描述符。

   类方法描述符公开在被访问时接收类而不是实例的 C 方法。 这与为
   "tp_methods" 中的 "METH_CLASS" 条目创建的描述符属于同一种类，并且在
   Python 中显示为 "types.ClassMethodDescriptorType" 对象。

   成功时，返回指向该描述符的 *强引用*。 失败时返回 "NULL" 并设置异常
   。

int PyDescr_IsData(PyObject *descr)

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

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

   根据包装器描述符 *d* 和实例 *self* 创建一个新的绑定包装器对象。

   这是由 "PyDescr_NewWrapper()" 创建的包装器描述符的绑定形式。 当通过
   实例访问槽位包装器时，CPython 会创建这些对象，它们在 Python 中显示
   为 "types.MethodWrapperType" 对象。

   成功时，返回指向该包装器对象的 *强引用*。 失败时返回 "NULL" 并设置
   异常。

PyDescr_TYPE(descr)

   Return a *borrowed reference* to the type that the descriptor
   *descr* belongs to. This is accessible as "__objclass__" in Python.

   *descr* must be a descriptor object created by one of the
   "PyDescr_New*" functions (an instance of "PyMethodDescr_Type",
   "PyClassMethodDescr_Type", "PyMemberDescr_Type",
   "PyGetSetDescr_Type", or "PyWrapperDescr_Type"). If the passed
   descriptor is not an instance of one of these types, the behavior
   is undefined.

PyDescr_NAME(descr)

   Return the name of the descriptor *descr* as a *borrowed reference*
   to a "str" object. This is available as "__name__" in Python.

   *descr* must be a descriptor object created by one of the
   "PyDescr_New*" functions. If not, the behavior is undefined.

PyDescr_COMMON

   This is a macro including the common fields for a descriptor
   object.

   This was included in Python's C API by mistake; do not use it in
   extensions. For creating custom descriptor objects, create a class
   implementing the descriptor protocol ("tp_descr_get" and
   "tp_descr_set").

   自 3.15 版起已处于 Soft deprecated 状态.


内置描述器
==========

PyTypeObject PyProperty_Type
    * 属于 稳定 ABI.*

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

PyTypeObject PySuper_Type
    * 属于 稳定 ABI.*

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

PyTypeObject PyClassMethod_Type

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

PyTypeObject PyClassMethodDescr_Type
    * 属于 稳定 ABI.*

   C 级别类方法描述符对象的类型对象。 这是为在 C 扩展类型中定义的
   "classmethod()" 创建的描述符的类型，对应于 Python 中的
   "types.ClassMethodDescriptorType" 对象。

PyObject *PyClassMethod_New(PyObject *callable)

   新建一个包裹 *callable* 的 "classmethod" 对象。*callable* 必须是一
   个可调用对象，并且不可为 "NULL" 值。

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

PyTypeObject PyStaticMethod_Type

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

PyObject *PyStaticMethod_New(PyObject *callable)

   新建一个包裹 *callable* 的 "staticmethod" 对象。*callable* 必须是一
   个可调用对象，并且不可为 "NULL" 值。

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