# Descriptor（描述器）物件

"Descriptor" 是描述物件某些屬性的物件，它們存在於型別物件的 dictionary（字典）中。

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)

  如果 descriptor 物件 descr 描述的是一個資料屬性則回傳非零值，或者如果它描述的是一個方法則回傳 `0`。descr 必須為一個 descriptor 物件；沒有錯誤檢查。

PyObject *PyWrapper_New(PyObject*, PyObject*)
  回傳值：新的參照。 為 穩定 ABI 的一部分.

PyDescr_COMMON

  This is a soft deprecated 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`).

## 內建描述器

PyTypeObject PyProperty_Type
  為 穩定 ABI 的一部分.

  The type object for property objects. This is the same object as `property` in the Python layer.

PyTypeObject PySuper_Type
  為 穩定 ABI 的一部分.

  The type object for super objects. This is the same object as `super` in the Python layer.

PyTypeObject PyClassMethod_Type

  The type of class method objects. This is the same object as `classmethod` in the Python layer.

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)

  Create a new `classmethod` object wrapping callable. callable must be a callable object and must not be `NULL`.

  On success, this function returns a strong reference to a new class method descriptor. On failure, this function returns `NULL` with an exception set.

PyTypeObject PyStaticMethod_Type

  The type of static method objects. This is the same object as `staticmethod` in the Python layer.

PyObject *PyStaticMethod_New(PyObject *callable)

  Create a new `staticmethod` object wrapping callable. callable must be a callable object and must not be `NULL`.

  On success, this function returns a strong reference to a new static method descriptor. On failure, this function returns `NULL` with an exception set.