> **Источник:** https://python-all.ru/3.11/c-api/structures.html > > «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor. --- # Структуры общих объектов При определении типов объектов Python используется большое количество структур. В данном разделе описываются эти структуры и принципы их использования. ## Базовые типы объектов и макросы Все объекты Python имеют в начале своего представления в памяти небольшое число общих полей. Эти поля описываются типами [`PyObject`](https://python-all.ru/3.11/c-api/structures.html#c.PyObject) и [`PyVarObject`](https://python-all.ru/3.11/c-api/structures.html#c.PyVarObject), которые, в свою очередь, определяются через раскрытие некоторых макросов, используемых (прямо или косвенно) при определении всех остальных объектов Python. #### `type PyObject` *Часть [Limited API](https://python-all.ru/3.11/c-api/stable.html#stable). (Только некоторые члены являются частью стабильного ABI.)* Все типы объектов являются расширениями этого типа. Это тип, который содержит информацию, необходимую Python для обработки указателя на объект как объекта. В обычной «релизной» сборке он содержит только счетчик ссылок объекта и указатель на соответствующий объект типа. Ничто не объявлено как [`PyObject`](https://python-all.ru/3.11/c-api/structures.html#c.PyObject), но любой указатель на объект Python может быть приведен к [PyObject](https://python-all.ru/3.11/c-api/structures.html#c.PyObject)\*. Доступ к членам должен осуществляться с помощью макросов [`Py_REFCNT`](https://python-all.ru/3.11/c-api/structures.html#c.Py_REFCNT) и [`Py_TYPE`](https://python-all.ru/3.11/c-api/structures.html#c.Py_TYPE). #### `type PyVarObject` *Часть [Limited API](https://python-all.ru/3.11/c-api/stable.html#stable). (Только некоторые члены являются частью стабильного ABI.)* Это расширение [`PyObject`](https://python-all.ru/3.11/c-api/structures.html#c.PyObject), добавляющее поле [`ob_size`](https://python-all.ru/3.11/c-api/typeobj.html#c.PyVarObject.ob_size). Он используется только для объектов, которые имеют некоторое понятие *длины*. Этот тип не часто встречается в Python/C API. Доступ к членам должен осуществляться с помощью макросов [`Py_REFCNT`](https://python-all.ru/3.11/c-api/structures.html#c.Py_REFCNT), [`Py_TYPE`](https://python-all.ru/3.11/c-api/structures.html#c.Py_TYPE) и [`Py_SIZE`](https://python-all.ru/3.11/c-api/structures.html#c.Py_SIZE). #### `PyObject_HEAD` Это макрос, используемый при объявлении новых типов, представляющих объекты без изменяемой длины. Макрос PyObject\_HEAD раскрывается в: ```c PyObject ob_base; ``` См. документацию [`PyObject`](https://python-all.ru/3.11/c-api/structures.html#c.PyObject) выше. #### `PyObject_VAR_HEAD` Это макрос, используемый при объявлении новых типов, представляющих объекты с длиной, которая меняется от экземпляра к экземпляру. Макрос PyObject\_VAR\_HEAD раскрывается в: ```c PyVarObject ob_base; ``` См. документацию [`PyVarObject`](https://python-all.ru/3.11/c-api/structures.html#c.PyVarObject) выше. #### `int Py_Is(PyObject *x, PyObject *y)` *Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable) начиная с версии 3.10.* Проверяет, является ли объект *x* тем же объектом, что и *y*, аналогично `x is y` в Python. Новое в версии 3.10. #### `int Py_IsNone(PyObject *x)` *Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable) начиная с версии 3.10.* Проверяет, является ли объект синглтоном `None`, аналогично `x is None` в Python. Новое в версии 3.10. #### `int Py_IsTrue(PyObject *x)` *Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable) начиная с версии 3.10.* Проверяет, является ли объект синглтоном `True`, аналогично `x is True` в Python. Новое в версии 3.10. #### `int Py_IsFalse(PyObject *x)` *Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable) начиная с версии 3.10.* Проверяет, является ли объект синглтоном `False`, аналогично `x is False` в Python. Новое в версии 3.10. #### `PyTypeObject *Py_TYPE(PyObject *o)` Возвращает тип объекта Python *o*. Возвращает [заимствованную ссылку](https://python-all.ru/3.11/glossary.html#term-borrowed-reference). Для установки типа объекта используется функция [`Py_SET_TYPE()`](https://python-all.ru/3.11/c-api/structures.html#c.Py_SET_TYPE). Изменено в версии 3.11: [`Py_TYPE()`](https://python-all.ru/3.11/c-api/structures.html#c.Py_TYPE) изменён на встроенную статическую функцию. Тип параметра больше не const [PyObject](https://python-all.ru/3.11/c-api/structures.html#c.PyObject)\*. #### `int Py_IS_TYPE(PyObject *o, PyTypeObject *type)` Возвращает ненулевое значение, если тип объекта *o* равен *type*. В противном случае возвращает нуль. Эквивалентно `Py_TYPE(o) == type`. Новое в версии 3.9. #### `void Py_SET_TYPE(PyObject *o, PyTypeObject *type)` Устанавливает тип объекта *o* в *type*. Новое в версии 3.9. #### `Py_ssize_t Py_REFCNT(PyObject *o)` Возвращает счётчик ссылок объекта Python *o*. Используйте функцию [`Py_SET_REFCNT()`](https://python-all.ru/3.11/c-api/structures.html#c.Py_SET_REFCNT) для установки счётчика ссылок объекта. Изменено в версии 3.11: Тип параметра больше не const [PyObject](https://python-all.ru/3.11/c-api/structures.html#c.PyObject)\*. Изменено в версии 3.10: [`Py_REFCNT()`](https://python-all.ru/3.11/c-api/structures.html#c.Py_REFCNT) изменён на встраиваемую статическую функцию. #### `void Py_SET_REFCNT(PyObject *o, Py_ssize_t refcnt)` Устанавливает счётчик ссылок объекта *o* в значение *refcnt*. Новое в версии 3.9. #### `Py_ssize_t Py_SIZE(PyVarObject *o)` Возвращает размер объекта Python *o*. Для установки размера объекта используется функция [`Py_SET_SIZE()`](https://python-all.ru/3.11/c-api/structures.html#c.Py_SET_SIZE). Изменено в версии 3.11: [`Py_SIZE()`](https://python-all.ru/3.11/c-api/structures.html#c.Py_SIZE) изменён на встроенную статическую функцию. Тип параметра больше не const [PyVarObject](https://python-all.ru/3.11/c-api/structures.html#c.PyVarObject)\*. #### `void Py_SET_SIZE(PyVarObject *o, Py_ssize_t size)` Устанавливает размер объекта *o* в *size*. Новое в версии 3.9. #### `PyObject_HEAD_INIT(type)` Это макрос, который раскрывается в значения инициализации для нового типа [`PyObject`](https://python-all.ru/3.11/c-api/structures.html#c.PyObject). Этот макрос раскрывается в: ```c _PyObject_EXTRA_INIT 1, type, ``` #### `PyVarObject_HEAD_INIT(type, size)` Это макрос, который разворачивается в значения инициализации для нового типа [`PyVarObject`](https://python-all.ru/3.11/c-api/structures.html#c.PyVarObject), включая поле [`ob_size`](https://python-all.ru/3.11/c-api/typeobj.html#c.PyVarObject.ob_size). Этот макрос разворачивается в: ```c _PyObject_EXTRA_INIT 1, type, size, ``` ## Реализация функций и методов #### `type PyCFunction` *Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable).* Тип функций, используемых для реализации большинства вызываемых объектов Python на C. Функции этого типа принимают два параметра [PyObject](https://python-all.ru/3.11/c-api/structures.html#c.PyObject)\* и возвращают одно такое значение. Если возвращаемое значение равно `NULL`, должно быть установлено исключение. Если не `NULL`, возвращаемое значение интерпретируется как возвращаемое значение функции, доступной в Python. Функция должна возвращать новую ссылку. Сигнатура функции: ```c PyObject *PyCFunction(PyObject *self, PyObject *args); ``` #### `type PyCFunctionWithKeywords` *Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable).* Тип функций, используемых для реализации вызываемых объектов Python на C с сигнатурой [METH\_VARARGS | METH\_KEYWORDS](https://python-all.ru/3.11/c-api/structures.html#meth-varargs-meth-keywords). Сигнатура функции: ```c PyObject *PyCFunctionWithKeywords(PyObject *self, PyObject *args, PyObject *kwargs); ``` #### `type _PyCFunctionFast` Тип функций, используемых для реализации вызываемых объектов Python на C с сигнатурой [`METH_FASTCALL`](https://python-all.ru/3.11/c-api/structures.html#c.METH_FASTCALL). Сигнатура функции: ```c PyObject *_PyCFunctionFast(PyObject *self, PyObject *const *args, Py_ssize_t nargs); ``` #### `type _PyCFunctionFastWithKeywords` Тип функций, используемых для реализации вызываемых объектов Python на C с сигнатурой [METH\_FASTCALL | METH\_KEYWORDS](https://python-all.ru/3.11/c-api/structures.html#meth-fastcall-meth-keywords). Сигнатура функции: ```c PyObject *_PyCFunctionFastWithKeywords(PyObject *self, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames); ``` #### `type PyCMethod` Тип функций, используемых для реализации вызываемых объектов Python на C с сигнатурой [METH\_METHOD | METH\_FASTCALL | METH\_KEYWORDS](https://python-all.ru/3.11/c-api/structures.html#meth-method-meth-fastcall-meth-keywords). Сигнатура функции: ```c PyObject *PyCMethod(PyObject *self, PyTypeObject *defining_class, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames) ``` Новое в версии 3.9. #### `type PyMethodDef` *Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable) (включая все члены).* Структура, используемая для описания метода типа-расширения. Эта структура имеет четыре поля: #### `const char *ml_name` Имя метода. #### `PyCFunction ml_meth` Указатель на реализацию на C. #### `int ml_flags` Битовые флаги, указывающие, как должен быть построен вызов. #### `const char *ml_doc` Указывает на содержимое строки документации. [`ml_meth`](https://python-all.ru/3.11/c-api/structures.html#c.PyMethodDef.ml_meth) – это указатель на функцию C. Функции могут быть разных tипов, но они всегда возвращают [PyObject](https://python-all.ru/3.11/c-api/structures.html#c.PyObject)\*. Если функция не относится к [`PyCFunction`](https://python-all.ru/3.11/c-api/structures.html#c.PyCFunction), компилятор потребует приведения типов в таблице методов. Хотя [`PyCFunction`](https://python-all.ru/3.11/c-api/structures.html#c.PyCFunction) определяет первый параметр как [PyObject](https://python-all.ru/3.11/c-api/structures.html#c.PyObject)\*, обычно реализация метода использует конкретный тип C объекта *self*. Поле [`ml_flags`](https://python-all.ru/3.11/c-api/structures.html#c.PyMethodDef.ml_flags) – это битовое поле, которое может содержать следующие флаги. Отдельные флаги указывают либо соглашение о вызове, либо соглашение о связывании. Существуют следующие соглашения о вызове: #### `METH_VARARGS` Это типичное соглашение о вызове, при котором методы имеют тип [`PyCFunction`](https://python-all.ru/3.11/c-api/structures.html#c.PyCFunction). Функция ожидает два значения [PyObject](https://python-all.ru/3.11/c-api/structures.html#c.PyObject)\*. Первое – это объект *self* для методов; для функций модуля это объект модуля. Второй параметр (часто называемый *args*) – это объект-кортеж, представляющий все аргументы. Этот параметр обычно обрабатывается с помощью [`PyArg_ParseTuple()`](https://python-all.ru/3.11/c-api/arg.html#c.PyArg_ParseTuple) или [`PyArg_UnpackTuple()`](https://python-all.ru/3.11/c-api/arg.html#c.PyArg_UnpackTuple). #### `METH_KEYWORDS` Может использоваться только в определённых комбинациях с другими флагами: [METH\_VARARGS | METH\_KEYWORDS](https://python-all.ru/3.11/c-api/structures.html#meth-varargs-meth-keywords), [METH\_FASTCALL | METH\_KEYWORDS](https://python-all.ru/3.11/c-api/structures.html#meth-fastcall-meth-keywords) и [METH\_METHOD | METH\_FASTCALL | METH\_KEYWORDS](https://python-all.ru/3.11/c-api/structures.html#meth-method-meth-fastcall-meth-keywords). **[METH\_VARARGS](https://python-all.ru/3.11/c-api/structures.html#c.METH_VARARGS) | [METH\_KEYWORDS](https://python-all.ru/3.11/c-api/structures.html#c.METH_KEYWORDS)** Методы с этими флагами должны быть типа [`PyCFunctionWithKeywords`](https://python-all.ru/3.11/c-api/structures.html#c.PyCFunctionWithKeywords). Функция ожидает три параметра: *self*, *args*, *kwargs*, где *kwargs* – это словарь всех именованных аргументов или `NULL`, если именованных аргументов нет. Параметры обычно обрабатываются с помощью [`PyArg_ParseTupleAndKeywords()`](https://python-all.ru/3.11/c-api/arg.html#c.PyArg_ParseTupleAndKeywords). #### `METH_FASTCALL` Быстрое соглашение о вызове, поддерживающее только позиционные аргументы. Методы имеют тип [`_PyCFunctionFast`](https://python-all.ru/3.11/c-api/structures.html#c._PyCFunctionFast). Первый параметр – *self*, второй параметр – массив C из значений [PyObject](https://python-all.ru/3.11/c-api/structures.html#c.PyObject)\*, указывающих аргументы, а третий параметр – количество аргументов (длина массива). Добавлено в версии 3.7. Изменено в версии 3.10: `METH_FASTCALL` теперь является частью [стабильного ABI](https://python-all.ru/3.11/c-api/stable.html#stable-abi). **[METH\_FASTCALL](https://python-all.ru/3.11/c-api/structures.html#c.METH_FASTCALL) | [METH\_KEYWORDS](https://python-all.ru/3.11/c-api/structures.html#c.METH_KEYWORDS)** Расширение [`METH_FASTCALL`](https://python-all.ru/3.11/c-api/structures.html#c.METH_FASTCALL), также поддерживающее именованные аргументы, с методами типа [`_PyCFunctionFastWithKeywords`](https://python-all.ru/3.11/c-api/structures.html#c._PyCFunctionFastWithKeywords). Именованные аргументы передаются так же, как в [протоколе vectorcall](https://python-all.ru/3.11/c-api/call.html#vectorcall): добавляется четвёртый параметр [PyObject](https://python-all.ru/3.11/c-api/structures.html#c.PyObject)\*, который является кортежем, представляющим имена именованных аргументов (гарантированно строки) или `NULL`, если ключевых слов нет. Значения именованных аргументов хранятся в массиве *args* после позиционных аргументов. Добавлено в версии 3.7. #### `METH_METHOD` Может использоваться только в комбинации с другими флагами: [METH\_METHOD | METH\_FASTCALL | METH\_KEYWORDS](https://python-all.ru/3.11/c-api/structures.html#meth-method-meth-fastcall-meth-keywords). **[METH\_METHOD](https://python-all.ru/3.11/c-api/structures.html#c.METH_METHOD) | [METH\_FASTCALL](https://python-all.ru/3.11/c-api/structures.html#c.METH_FASTCALL) | [METH\_KEYWORDS](https://python-all.ru/3.11/c-api/structures.html#c.METH_KEYWORDS)** Расширение [METH\_FASTCALL | METH\_KEYWORDS](https://python-all.ru/3.11/c-api/structures.html#meth-fastcall-meth-keywords), поддерживающее *определяющий класс*, то есть класс, который содержит данный метод. Определяющий класс может быть суперклассом `Py_TYPE(self)`. Метод должен быть типа [`PyCMethod`](https://python-all.ru/3.11/c-api/structures.html#c.PyCMethod), как и для `METH_FASTCALL | METH_KEYWORDS` с добавленным аргументом `defining_class` после `self`. Новое в версии 3.9. #### `METH_NOARGS` Методы без параметров не должны проверять, переданы ли аргументы, если они перечислены с флагом [`METH_NOARGS`](https://python-all.ru/3.11/c-api/structures.html#c.METH_NOARGS). Они должны быть типа [`PyCFunction`](https://python-all.ru/3.11/c-api/structures.html#c.PyCFunction). Первый параметр обычно называется *self* и будет содержать ссылку на модуль или экземпляр объекта. Во всех случаях второй параметр будет `NULL`. Функция должна иметь 2 параметра. Поскольку второй параметр не используется, [`Py_UNUSED`](https://python-all.ru/3.11/c-api/intro.html#c.Py_UNUSED) можно использовать для предотвращения предупреждения компилятора. #### `METH_O` Методы с одним объектным аргументом могут быть перечислены с флагом [`METH_O`](https://python-all.ru/3.11/c-api/structures.html#c.METH_O) вместо вызова [`PyArg_ParseTuple()`](https://python-all.ru/3.11/c-api/arg.html#c.PyArg_ParseTuple) с аргументом `"O"`. Они имеют тип [`PyCFunction`](https://python-all.ru/3.11/c-api/structures.html#c.PyCFunction), с параметром *self* и параметром [PyObject](https://python-all.ru/3.11/c-api/structures.html#c.PyObject)\*, представляющим единственный аргумент. Эти две константы не используются для указания соглашения о вызовах, а для привязки при использовании с методами классов. Они не могут использоваться для функций, определённых для модулей. Для любого данного метода может быть установлен не более чем один из этих флагов. #### `METH_CLASS` Метод получит объект типа в качестве первого параметра, а не экземпляр типа. Это используется для создания *методов класса*, аналогично тому, что создаётся при использовании [`classmethod()`](https://python-all.ru/3.11/library/functions.html#classmethod) встроенной функции. #### `METH_STATIC` Метод получит `NULL` в качестве первого параметра, а не экземпляр типа. Это используется для создания *статических методов*, аналогично тому, что создаётся при использовании встроенной функции [`staticmethod()`](https://python-all.ru/3.11/library/functions.html#staticmethod). Ещё одна константа управляет тем, загружается ли метод вместо другого определения с тем же именем метода. #### `METH_COEXIST` Метод будет загружен вместо существующих определений. Без *METH\_COEXIST* по умолчанию повторяющиеся определения пропускаются. Поскольку обёртки слотов загружаются до таблицы методов, наличие слота *sq\_contains*, например, приведёт к созданию обёрнутого метода с именем [`__contains__()`](https://python-all.ru/3.11/reference/datamodel.html#object.__contains__) и предотвратит загрузку соответствующего PyCFunction с тем же именем. При установленном флаге PyCFunction будет загружен вместо объекта-обёртки и будет сосуществовать со слотом. Это полезно, поскольку вызовы PyCFunctions оптимизированы лучше, чем вызовы объектов-обёрток. #### `PyObject *PyCMethod_New(PyMethodDef *ml, PyObject *self, PyObject *module, PyTypeObject *cls)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable) с версии 3.9.* Преобразует *ml* в объект Python [callable](https://python-all.ru/3.11/glossary.html#term-callable). Вызывающий код должен гарантировать, что *ml* переживёт [callable](https://python-all.ru/3.11/glossary.html#term-callable). Обычно *ml* определяется как статическая переменная. Параметр *self* будет передан как аргумент *self* в C-функцию из `ml->ml_meth` при вызове. *self* может быть `NULL`. Атрибут `__module__` объекта [callable](https://python-all.ru/3.11/glossary.html#term-callable) можно задать из аргумента *module*. *module* должна быть строкой Python, которая будет использоваться как имя модуля, в котором определена функция. Если это недоступно, можно задать [`None`](https://python-all.ru/3.11/library/constants.html#None) или `NULL`. > **См. также** > > [`function.__module__`](https://python-all.ru/3.11/reference/datamodel.html#function.__module__) Параметр *cls* будет передан как аргумент *defining\_class* в C-функцию. Должен быть задан, если [`METH_METHOD`](https://python-all.ru/3.11/c-api/structures.html#c.METH_METHOD) установлен на `ml->ml_flags`. Новое в версии 3.9. #### `PyObject *PyCFunction_NewEx(PyMethodDef *ml, PyObject *self, PyObject *module)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable).* Эквивалентно `PyCMethod_New(ml, self, module, NULL)`. #### `PyObject *PyCFunction_New(PyMethodDef *ml, PyObject *self)` *Возвращаемое значение: новая ссылка.* *Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable) с версии 3.4.* Эквивалентно `PyCMethod_New(ml, self, NULL, NULL)`. ## Доступ к атрибутам типов расширений #### `type PyMemberDef` *Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable) (включая все члены).* Структура, описывающая атрибут типа, который соответствует члену C-структуры. Её поля: | Поле | Тип C | Значение | | --- | --- | --- | | `name` | const char \* | имя члена | | `type` | int | тип члена в C-структуре | | `offset` | Py\_ssize\_t | смещение в байтах, по которому член расположен в объектной структуре типа | | `flags` | int | биты флага, указывающие, должно ли поле быть только для чтения или доступным для записи | | `doc` | const char \* | указывает на содержимое докстринга | `type` может быть одним из многих макросов `T_`, соответствующих различным C типам. При обращении к члену из Python он будет преобразован в эквивалентный тип Python. | Имя макроса | Тип C | | --- | --- | | T\_SHORT | short | | T\_INT | int | | T\_LONG | long | | T\_FLOAT | float | | T\_DOUBLE | double | | T\_STRING | const char \* | | T\_OBJECT | PyObject \* | | T\_OBJECT\_EX | PyObject \* | | T\_CHAR | char | | T\_BYTE | char | | T\_UBYTE | unsigned char | | T\_UINT | unsigned int | | T\_USHORT | unsigned short | | T\_ULONG | unsigned long | | T\_BOOL | char | | T\_LONGLONG | long long | | T\_ULONGLONG | unsigned long long | | T\_PYSSIZET | Py\_ssize\_t | `T_OBJECT` и `T_OBJECT_EX` различаются тем, что `T_OBJECT` возвращает `None`, если член равен `NULL`, а `T_OBJECT_EX` возбуждает [`AttributeError`](https://python-all.ru/3.11/library/exceptions.html#AttributeError). Старайтесь использовать `T_OBJECT_EX` вместо `T_OBJECT`, потому что `T_OBJECT_EX` правильнее обрабатывает использование оператора [`del`](https://python-all.ru/3.11/reference/simple_stmts.html#del) для этого атрибута, чем `T_OBJECT`. `flags` может быть `0` для доступа на запись и чтение или `READONLY` для доступа только на чтение. Использование `T_STRING` для [`type`](https://python-all.ru/3.11/library/functions.html#type) подразумевает `READONLY`. Данные `T_STRING` интерпретируются как UTF-8. Удалять можно только члены `T_OBJECT` и `T_OBJECT_EX`. (Они устанавливаются в `NULL`). Heap allocated types (created using [`PyType_FromSpec()`](https://python-all.ru/3.11/c-api/type.html#c.PyType_FromSpec) or similar), `PyMemberDef` may contain definitions for the special members `__dictoffset__`, `__weaklistoffset__` and `__vectorcalloffset__`, corresponding to [`tp_dictoffset`](https://python-all.ru/3.11/c-api/typeobj.html#c.PyTypeObject.tp_dictoffset), [`tp_weaklistoffset`](https://python-all.ru/3.11/c-api/typeobj.html#c.PyTypeObject.tp_weaklistoffset) and [`tp_vectorcall_offset`](https://python-all.ru/3.11/c-api/typeobj.html#c.PyTypeObject.tp_vectorcall_offset) in type objects. These must be defined with `T_PYSSIZET` and `READONLY`, for example: ```c static PyMemberDef spam_type_members[] = { {"__dictoffset__", T_PYSSIZET, offsetof(Spam_object, dict), READONLY}, {NULL} /* Страж */ }; ``` #### `PyObject *PyMember_GetOne(const char *obj_addr, struct PyMemberDef *m)` Получает атрибут, принадлежащий объекту по адресу *obj\_addr*. Атрибут описывается с помощью `PyMemberDef` *m*. Возвращает `NULL` при ошибке. #### `int PyMember_SetOne(char *obj_addr, struct PyMemberDef *m, PyObject *o)` Устанавливает атрибут, принадлежащий объекту по адресу *obj\_addr*, в значение объекта *o*. Устанавливаемый атрибут описывается с помощью `PyMemberDef` *m*. Возвращает `0` в случае успеха и отрицательное значение при ошибке. #### `type PyGetSetDef` *Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable) (включая все члены).* Структура для определения доступа по типу свойства для типа. См. также описание слота [`PyTypeObject.tp_getset`](https://python-all.ru/3.11/c-api/typeobj.html#c.PyTypeObject.tp_getset). | Поле | Тип C | Значение | | --- | --- | --- | | имя | const char \* | имя атрибута | | get | getter | C-функция для получения атрибута | | множество | setter | необязательная C-функция для установки или удаления атрибута, если не указана, атрибут доступен только для чтения | | doc | const char \* | необязательная строка документации | | closure | void \* | необязательный указатель на пользовательские данные, предоставляющий дополнительные данные для getter и setter | Функция `get` принимает один параметр [PyObject](https://python-all.ru/3.11/c-api/structures.html#c.PyObject)\* (экземпляр) и указатель на пользовательские данные (связанный `closure`): ```c typedef PyObject *(*getter)(PyObject *, void *); ``` В случае успеха должна возвращать новую ссылку или `NULL` с установленным исключением в случае неудачи. Функции `set` принимают два параметра [PyObject](https://python-all.ru/3.11/c-api/structures.html#c.PyObject)\* (экземпляр и устанавливаемое значение) и указатель на пользовательские данные (связанный `closure`): ```c typedef int (*setter)(PyObject *, PyObject *, void *); ``` Если атрибут должен быть удален, второй параметр равен `NULL`. В случае успеха должна возвращать `0` или `-1` с установленным исключением в случае неудачи.