> **Источник:** https://python-all.ru/3.8/c-api/type.html > > «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor. --- # Объекты типов **`PyTypeObject`** C-структура объектов, используемая для описания встроенных типов. **[PyObject](https://python-all.ru/3.8/c-api/structures.html#c.PyObject)\* `PyType_Type`** Это объект типа для объектов-типов; он совпадает с объектом [`type`](https://python-all.ru/3.8/library/functions.html#type) на уровне Python. #### `int PyType_Check(PyObject *o)` Возвращает истину, если объект *o* является объектом типа, включая экземпляры типов, производных от стандартного объекта типа. В остальных случаях возвращает ложь. #### `int PyType_CheckExact(PyObject *o)` Возвращает истину, если объект *o* является объектом типа, но не подтипом стандартного объекта типа. В остальных случаях возвращает ложь. #### `unsigned int PyType_ClearCache()` Очищает внутренний кеш поиска. Возвращает текущий тег версии. #### `unsigned long PyType_GetFlags(PyTypeObject* type)` Возвращает элемент [`tp_flags`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_flags) *type*. Эта функция в первую очередь предназначена для использования с *Py\_LIMITED\_API*; отдельные биты флагов гарантированно стабильны во всех выпусках Python, но доступ к [`tp_flags`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_flags) самому по себе не является частью ограниченного API. Новое в версии 3.2. Изменено в версии 3.4: Тип возвращаемого значения теперь `unsigned long`, а не `long`. #### `void PyType_Modified(PyTypeObject *type)` Аннулирует внутренний кеш поиска для типа и всех его подтипов. Эта функция должна вызываться после любого ручного изменения атрибутов или базовых классов типа. #### `int PyType_HasFeature(PyTypeObject *o, int feature)` Возвращает истину, если объект типа *o* устанавливает признак *feature*. Признаки типа задаются одноразрядными флагами. #### `int PyType_IS_GC(PyTypeObject *o)` Возвращает истину, если объект типа поддерживает детектор циклов; это проверяет флаг типа [`Py_TPFLAGS_HAVE_GC`](https://python-all.ru/3.8/c-api/typeobj.html#Py_TPFLAGS_HAVE_GC). #### `int PyType_IsSubtype(PyTypeObject *a, PyTypeObject *b)` Возвращает истину, если *a* является подтипом *b*. Эта функция проверяет только непосредственные подтипы, то есть [`__subclasscheck__()`](https://python-all.ru/3.8/reference/datamodel.html#class.__subclasscheck__) не вызывается для *b*. Вызовите [`PyObject_IsSubclass()`](https://python-all.ru/3.8/c-api/object.html#c.PyObject_IsSubclass), чтобы выполнить ту же проверку, что и [`issubclass()`](https://python-all.ru/3.8/library/functions.html#issubclass) . #### `PyObject* PyType_GenericAlloc(PyTypeObject *type, Py_ssize_t nitems)` *Возвращаемое значение: новая ссылка.* Универсальный обработчик для слота [`tp_alloc`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_alloc) объекта-типа. Использует стандартный механизм выделения памяти Python для создания нового экземпляра и инициализации всего его содержимого значением `NULL`. #### `PyObject* PyType_GenericNew(PyTypeObject *type, PyObject *args, PyObject *kwds)` *Возвращаемое значение: новая ссылка.* Универсальный обработчик для слота [`tp_new`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_new) объекта-типа. Создаёт новый экземпляр, используя слот [`tp_alloc`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_alloc) типа. #### `int PyType_Ready(PyTypeObject *type)` Завершает инициализацию объекта типа. Должна вызываться для всех объектов типа, чтобы завершить их инициализацию. Эта функция отвечает за добавление наследуемых слотов из базового класса. Возвращает `0` при успехе, или `-1` и устанавливает исключение при ошибке. #### `void* PyType_GetSlot(PyTypeObject *type, int slot)` Возвращает указатель на функцию, хранящийся в указанном слоте. Если результат равен `NULL`, это означает, что либо слот `NULL`, либо функция была вызвана с недопустимыми параметрами. Обычно вызывающий код приводит указатель результата к соответствующему типу функции. См. `PyType_Slot.slot` для возможных значений аргумента *slot*. Исключение возбуждается, если *type* не является типом кучи. Новое в версии 3.4. ## Создание типов, размещаемых в куче Следующие функции и структуры используются для создания [динамических типов](https://python-all.ru/3.8/c-api/typeobj.html#heap-types). #### `PyObject* PyType_FromSpecWithBases(PyType_Spec *spec, PyObject *bases)` *Возвращаемое значение: новая ссылка.* Создаёт и возвращает объект типа кучи из *spec* ([`Py_TPFLAGS_HEAPTYPE`](https://python-all.ru/3.8/c-api/typeobj.html#Py_TPFLAGS_HEAPTYPE)). Если *bases* является кортежем, созданный тип кучи содержит все типы, содержащиеся в нём, как базовые типы. Если *bases* равно `NULL`, вместо него используется слот *Py\_tp\_bases*. Если и он равен `NULL`, используется слот *Py\_tp\_base*. Если и он равен `NULL`, новый тип наследуется от [`object`](https://python-all.ru/3.8/library/functions.html#object). Эта функция вызывает [`PyType_Ready()`](https://python-all.ru/3.8/c-api/type.html#c.PyType_Ready) у нового типа. Новое в версии 3.3. #### `PyObject* PyType_FromSpec(PyType_Spec *spec)` *Возвращаемое значение: новая ссылка.* Эквивалентно `PyType_FromSpecWithBases(spec, NULL)`. **`PyType_Spec`** Структура, определяющая поведение типа. **const char\* `PyType_Spec.name`** Имя типа, используемое для установки [`PyTypeObject.tp_name`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_name). **int `PyType_Spec.basicsize`** **int `PyType_Spec.itemsize`** Размер экземпляра в байтах; используется для установки [`PyTypeObject.tp_basicsize`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_basicsize) и [`PyTypeObject.tp_itemsize`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_itemsize). **int `PyType_Spec.flags`** Флаги типа, используются для установки [`PyTypeObject.tp_flags`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_flags). Если флаг `Py_TPFLAGS_HEAPTYPE` не установлен, [`PyType_FromSpecWithBases()`](https://python-all.ru/3.8/c-api/type.html#c.PyType_FromSpecWithBases) устанавливает его автоматически. **[PyType\_Slot](https://python-all.ru/3.8/c-api/type.html#c.PyType_Slot) \*`PyType_Spec.slots`** Массив структур [`PyType_Slot`](https://python-all.ru/3.8/c-api/type.html#c.PyType_Slot). Завершается специальным значением слота `{0, NULL}`. **`PyType_Slot`** Структура, определяющая дополнительную функциональность типа, содержащая идентификатор слота и указатель на значение. **int `PyType_Slot.slot`** Идентификатор слота. Идентификаторы слотов именуются подобно именам полей структур [`PyTypeObject`](https://python-all.ru/3.8/c-api/type.html#c.PyTypeObject), [`PyNumberMethods`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyNumberMethods), [`PySequenceMethods`](https://python-all.ru/3.8/c-api/typeobj.html#c.PySequenceMethods), [`PyMappingMethods`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyMappingMethods) и [`PyAsyncMethods`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyAsyncMethods) с добавлением префикса `Py_`. Например, используйте: - `Py_tp_dealloc` для установки [`PyTypeObject.tp_dealloc`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_dealloc) - `Py_nb_add` для установки [`PyNumberMethods.nb_add`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyNumberMethods.nb_add) - `Py_sq_length` для установки [`PySequenceMethods.sq_length`](https://python-all.ru/3.8/c-api/typeobj.html#c.PySequenceMethods.sq_length) Следующие поля нельзя задать с помощью [`PyType_Spec`](https://python-all.ru/3.8/c-api/type.html#c.PyType_Spec) и [`PyType_Slot`](https://python-all.ru/3.8/c-api/type.html#c.PyType_Slot): - [`tp_dict`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_dict) - [`tp_mro`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_mro) - [`tp_cache`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_cache) - [`tp_subclasses`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_subclasses) - [`tp_weaklist`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_weaklist) - `tp_print` - [`tp_weaklistoffset`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_weaklistoffset) - [`tp_dictoffset`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyTypeObject.tp_dictoffset) - [`bf_getbuffer`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyBufferProcs.bf_getbuffer) - [`bf_releasebuffer`](https://python-all.ru/3.8/c-api/typeobj.html#c.PyBufferProcs.bf_releasebuffer) Установка `Py_tp_bases` или `Py_tp_base` может быть проблематичной на некоторых платформах. Чтобы избежать проблем, используйте аргумент *bases* функции `PyType_FromSpecWithBases()` вместо этого. **void \*`PyType_Slot.pfunc`** Желаемое значение слота. В большинстве случаев это указатель на функцию. Не может быть `NULL`.