형 객체
*******

PyTypeObject

   내장형을 기술하는 데 사용되는 객체의 C 구조체.

PyTypeObject PyType_Type

   이것은 형 객체의 형 객체입니다; 파이썬 계층의 "type"과 같은 객체입
   니다.

int PyType_Check(PyObject *o)

   객체 *o*가 표준형 객체에서 파생된 형의 인스턴스를 포함하여 형 객체
   면 0이 아닌 값을 반환합니다. 다른 모든 경우 0을 반환합니다. 이 함수
   는 항상 성공합니다.

int PyType_CheckExact(PyObject *o)

   객체 *o*가 형 객체이지만, 표준형 객체의 서브 형이 아니면 0이 아닌
   값을 반환합니다. 다른 모든 경우 0을 반환합니다. 이 함수는 항상 성공
   합니다.

unsigned int PyType_ClearCache()

   내부 조회 캐시를 지웁니다. 현재의 버전 태그를 반환합니다.

unsigned long PyType_GetFlags(PyTypeObject* type)

   *type*의 "tp_flags" 멤버를 반환합니다. 이 함수는 주로
   *Py_LIMITED_API*와 함께 사용하기 위한 것입니다; 개별 플래그 비트는
   파이썬 배포 간에 안정적인 것으로 보장되지만, "tp_flags" 자체에 대한
   액세스는 제한된 API 일부가 아닙니다.

   버전 3.2에 추가.

   버전 3.4에서 변경: 반환형은 이제 "long"이 아니라 "unsigned long"입
   니다.

void PyType_Modified(PyTypeObject *type)

   형과 그것의 모든 서브 형에 대한 내부 검색 캐시를 무효로 합니다. 형
   의 어트리뷰트나 베이스 클래스를 수동으로 수정한 후에는 이 함수를 호
   출해야 합니다.

int PyType_HasFeature(PyTypeObject *o, int feature)

   형 객체 *o*가 기능 *feature*를 설정하면 0이 아닌 값을 반환합니다.
   형 기능은 단일 비트 플래그로 표시됩니다.

int PyType_IS_GC(PyTypeObject *o)

   형 객체가 순환 검출기에 대한 지원을 포함하고 있으면 참을 반환합니다
   . 이것은 형 플래그 "Py_TPFLAGS_HAVE_GC"를 검사합니다.

int PyType_IsSubtype(PyTypeObject *a, PyTypeObject *b)

   *a*가 *b*의 서브 형이면 참을 반환합니다.

   이 함수는 실제 서브 형만 검사합니다. 즉, "__subclasscheck__()"가
   *b*에 대해 호출되지 않습니다. "issubclass()"가 수행하는 것과 같은
   검사를 하려면 "PyObject_IsSubclass()"를 호출하십시오.

PyObject* PyType_GenericAlloc(PyTypeObject *type, Py_ssize_t nitems)
    *Return value: New reference.*

   형 객체의 "tp_alloc" 슬롯을 위한 일반 처리기. 파이썬의 기본 메모리
   할당 메커니즘을 사용하여 새 인스턴스를 할당하고 모든 내용을 "NULL"
   로 초기화합니다.

PyObject* PyType_GenericNew(PyTypeObject *type, PyObject *args, PyObject *kwds)
    *Return value: New reference.*

   형 객체의 "tp_new" 슬롯을 위한 일반 처리기. 형의 "tp_alloc" 슬롯을
   사용하여 새 인스턴스를 만듭니다.

int PyType_Ready(PyTypeObject *type)

   형 개체를 마무리합니다. 초기화를 완료하려면 모든 형 객체에 대해 이
   메서드를 호출해야 합니다. 이 함수는 형의 베이스 클래스에서 상속된
   슬롯을 추가합니다. 성공 시 "0"을 반환하고, 오류 시 "-1"을 반환하고
   예외를 설정합니다.

   참고:

     If some of the base classes implements the GC protocol and the
     provided type does not include the "Py_TPFLAGS_HAVE_GC" in its
     flags, then the GC protocol will be automatically implemented
     from its parents. On the contrary, if the type being created does
     include "Py_TPFLAGS_HAVE_GC" in its flags then it **must**
     implement the GC protocol itself by at least implementing the
     "tp_traverse" handle.

void* PyType_GetSlot(PyTypeObject *type, int slot)

   지정된 슬롯에 저장된 함수 포인터를 반환합니다. 결과가 "NULL"이면,
   슬롯이 "NULL"이거나 함수가 유효하지 않은 매개 변수로 호출되었음을
   나타냅니다. 호출자는 일반적으로 결과 포인터를 적절한 함수 형으로 캐
   스팅합니다.

   *slot* 인자의 가능한 값은 "PyType_Slot.slot"을 참조하십시오.

   *type*이 힙 형이 아니면 예외가 발생합니다.

   버전 3.4에 추가.

PyObject* PyType_GetModule(PyTypeObject *type)

   "PyType_FromModuleAndSpec()"를 사용하여 형을 만들 때 지정된 형과 관
   련된 모듈 객체를 반환합니다.

   주어진 형과 연관된 모듈이 없으면, "TypeError"를 설정하고 "NULL"을
   반환합니다.

   이 함수는 일반적으로 메서드가 정의된 모듈을 가져오는 데 사용됩니다.
   이러한 메서드에서, "PyType_GetModule(Py_TYPE(self))"는 의도한 결과
   를 반환하지 않을 수 있음에 유의하십시오. "Py_TYPE(self)"는 의도한
   클래스의 *서브 클래스*일 수 있으며, 서브 클래스가 반드시 슈퍼 클래
   스와 같은 모듈에 정의된 것은 아닙니다. 메서드를 정의하는 클래스를
   얻으려면 "PyCMethod"를 참조하십시오.

   버전 3.9에 추가.

void* PyType_GetModuleState(PyTypeObject *type)

   주어진 형과 관련된 모듈 객체의 상태를 반환합니다.
   "PyType_GetModule()" 결과에 "PyModule_GetState()"를 호출하는 바로
   가기입니다.

   주어진 형과 연관된 모듈이 없으면, "TypeError"를 설정하고 "NULL"을
   반환합니다.

   *type*에 연관된 모듈이 있지만, 상태가 "NULL"이면, 예외를 설정하지
   않고 "NULL"을 반환합니다.

   버전 3.9에 추가.


힙에 할당된 형 만들기
=====================

다음 함수와 구조체는 힙 형을 만드는 데 사용됩니다.

PyObject* PyType_FromModuleAndSpec(PyObject *module, PyType_Spec *spec, PyObject *bases)
    *Return value: New reference.*

   *spec*으로 힙 형 객체를 만들고 반환합니다 ("Py_TPFLAGS_HEAPTYPE").

   *bases*가 튜플이면, 생성된 힙 형에는 그것에 포함된 모든 형이 베이스
   형으로 포함됩니다.

   *bases*가 "NULL"이면, *Py_tp_bases* 슬롯이 대신 사용됩니다. 그 또한
   "NULL"이면, *Py_tp_base* 슬롯이 대신 사용됩니다. 그 또한 "NULL"이면
   , 새 형은 "object"에서 파생됩니다.

   The *module* argument can be used to record the module in which the
   new class is defined. It must be a module object or "NULL". If not
   "NULL", the module is associated with the new type and can later be
   retrieved with "PyType_GetModule()". The associated module is not
   inherited by subclasses; it must be specified for each class
   individually.

   이 함수는 새로운 형에 "PyType_Ready()"를 호출합니다.

   버전 3.9에 추가.

PyObject* PyType_FromSpecWithBases(PyType_Spec *spec, PyObject *bases)
    *Return value: New reference.*

   "PyType_FromModuleAndSpec(NULL, spec, bases)"와 동등합니다.

   버전 3.3에 추가.

PyObject* PyType_FromSpec(PyType_Spec *spec)
    *Return value: New reference.*

   "PyType_FromSpecWithBases(spec, NULL)"와 동등합니다.

PyType_Spec

   형의 행동을 정의하는 구조체.

   const char* PyType_Spec.name

      형의 이름, "PyTypeObject.tp_name"을 설정하는 데 사용됩니다.

   int PyType_Spec.basicsize

   int PyType_Spec.itemsize

      인스턴스의 크기(바이트), "PyTypeObject.tp_basicsize"와
      "PyTypeObject.tp_itemsize"를 설정하는 데 사용됩니다.

   int PyType_Spec.flags

      형 플래그, "PyTypeObject.tp_flags"를 설정하는 데 사용됩니다.

      "Py_TPFLAGS_HEAPTYPE" 플래그가 설정되어 있지 않으면,
      "PyType_FromSpecWithBases()" 가 자동으로 플래그를 설정합니다.

   PyType_Slot *PyType_Spec.slots

      "PyType_Slot" 구조체의 배열. 특수 슬롯값 "{0, NULL}"에 의해 종료
      됩니다.

PyType_Slot

   형의 선택적 기능을 정의하는 구조체, 슬롯 ID와 값 포인터를 포함합니
   다.

   int PyType_Slot.slot

         슬롯 ID.

         슬롯 ID는 구조체 "PyTypeObject", "PyNumberMethods",
         "PySequenceMethods", "PyMappingMethods" 및 "PyAsyncMethods"
         의 필드 이름에 "Py_" 접두사를 붙인 이름을 사용합니다. 예를 들
         어, :

         * "PyTypeObject.tp_dealloc"을 설정하는 "Py_tp_dealloc"

         * "PyNumberMethods.nb_add"를 설정하는 "Py_nb_add"

         * "PySequenceMethods.sq_length"를 설정하는 "Py_sq_length"

         다음 필드는 "PyType_Spec"과 "PyType_Slot"을 사용하여 전혀 설
         정할 수 없습니다:

         * "tp_dict"

         * "tp_mro"

         * "tp_cache"

         * "tp_subclasses"

         * "tp_weaklist"

         * "tp_vectorcall"

         * "tp_weaklistoffset" (PyMemberDef를 참조하십시오)

         * "tp_dictoffset" (PyMemberDef를 참조하십시오)

         * "tp_vectorcall_offset" (PyMemberDef를 참조하십시오)

         다음 필드는 제한된 API에서 "PyType_Spec"과 "PyType_Slot"을 사
         용하여 설정할 수 없습니다:

         * "bf_getbuffer"

         * "bf_releasebuffer"

         일부 플랫폼에서는 "Py_tp_bases"나 "Py_tp_base"를 설정하는 것
         이 문제가 될 수 있습니다. 문제를 피하려면, 대신
         "PyType_FromSpecWithBases()" 의 *bases* 인자를 사용하십시오.

      버전 3.9에서 변경: Slots in "PyBufferProcs" may be set in the
      unlimited API.

   void *PyType_Slot.pfunc

      슬롯의 원하는 값입니다. 대부분 이것은 함수에 대한 포인터입니다.

      "NULL"이 아닐 수 있습니다.
