function.md

1> **Источник:** https://python-all.ru/3.8/c-api/function.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Объекты функций89Есть несколько функций, специфичных для функций Python.1011**`PyFunctionObject`**1213C-структура, используемая для функций.1415**[PyTypeObject](https://python-all.ru/3.8/c-api/type.html#c.PyTypeObject) `PyFunction_Type`**1617Это экземпляр [`PyTypeObject`](https://python-all.ru/3.8/c-api/type.html#c.PyTypeObject) и представляет тип функции Python. Он доступен программистам на Python как `types.FunctionType`.1819#### `int PyFunction_Check(PyObject *o)`2021Возвращает true, если *o* является объектом функции (имеет тип [`PyFunction_Type`](https://python-all.ru/3.8/c-api/function.html#c.PyFunction_Type)). Параметр не должен быть `NULL`.2223#### `PyObject* PyFunction_New(PyObject *code, PyObject *globals)`2425*Возвращаемое значение: новая ссылка.*2627Возвращает новый объект функции, связанный с объектом кода *code*. *globals* должен быть словарём с глобальными переменными, доступными функции.2829Докстринг и имя функции извлекаются из объекта кода. *\_\_module\_\_* извлекается из *globals*. Значения по умолчанию аргументов, аннотации и замыкание устанавливаются в `NULL`. *\_\_qualname\_\_* устанавливается в то же значение, что и имя функции.3031#### `PyObject* PyFunction_NewWithQualName(PyObject *code, PyObject *globals, PyObject *qualname)`3233*Возвращаемое значение: новая ссылка.*3435Как [`PyFunction_New()`](https://python-all.ru/3.8/c-api/function.html#c.PyFunction_New), но также позволяет задать атрибут `__qualname__` объекта функции. *qualname* должен быть объектом unicode или `NULL`; если `NULL`, атрибут `__qualname__` устанавливается в то же значение, что и его атрибут `__name__`.3637Новое в версии 3.3.3839#### `PyObject* PyFunction_GetCode(PyObject *op)`4041*Возвращаемое значение: заимствованная ссылка.*4243Возвращает объект кода, связанный с объектом функции *op*.4445#### `PyObject* PyFunction_GetGlobals(PyObject *op)`4647*Возвращаемое значение: заимствованная ссылка.*4849Возвращает словарь глобальных переменных, связанный с объектом функции *op*.5051#### `PyObject* PyFunction_GetModule(PyObject *op)`5253*Возвращаемое значение: заимствованная ссылка.*5455Возвращает атрибут *\_\_module\_\_* объекта-функции *op*. Обычно это строка с именем модуля, но может быть установлено в любой другой объект кодом Python.5657#### `PyObject* PyFunction_GetDefaults(PyObject *op)`5859*Возвращаемое значение: заимствованная ссылка.*6061Возвращает значения аргументов по умолчанию объекта функции *op*. Это может быть кортеж аргументов или `NULL`.6263#### `int PyFunction_SetDefaults(PyObject *op, PyObject *defaults)`6465Устанавливает значения аргументов по умолчанию для объекта функции *op*. *defaults* должен быть `Py_None` или кортежем.6667В случае ошибки возбуждает [`SystemError`](https://python-all.ru/3.8/library/exceptions.html#SystemError) и возвращает `-1`.6869#### `PyObject* PyFunction_GetClosure(PyObject *op)`7071*Возвращаемое значение: заимствованная ссылка.*7273Возвращает замыкание, связанное с функцией *op*. Может быть `NULL` или кортежем объектов-ячеек.7475#### `int PyFunction_SetClosure(PyObject *op, PyObject *closure)`7677Устанавливает замыкание для функции *op*. *closure* должен быть `Py_None` или кортежем объектов-ячеек.7879В случае ошибки возбуждает [`SystemError`](https://python-all.ru/3.8/library/exceptions.html#SystemError) и возвращает `-1`.8081#### `PyObject *PyFunction_GetAnnotations(PyObject *op)`8283*Возвращаемое значение: заимствованная ссылка.*8485Возвращает аннотации функции *op*. Может быть изменяемым словарём или `NULL`.8687#### `int PyFunction_SetAnnotations(PyObject *op, PyObject *annotations)`8889Устанавливает аннотации для функции *op*. *annotations* должен быть словарём или `Py_None`.9091В случае ошибки возбуждает [`SystemError`](https://python-all.ru/3.8/library/exceptions.html#SystemError) и возвращает `-1`.92