> **Источник:** https://python-all.ru/2.6/c-api/exceptions.html > > «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor. --- # Обработка исключений Функции, описанные в этой главе, позволяют обрабатывать и возбуждать исключения Python. Важно понимать некоторые основы обработки исключений в Python. Механизм в чём-то похож на переменную `errno` в Unix: существует глобальный индикатор (на поток) последней произошедшей ошибки. Большинство функций не сбрасывают его при успехе, но устанавливают, чтобы указать причину ошибки в случае неудачи. Большинство функций также возвращают индикатор ошибки – обычно *NULL*, если ожидается возврат указателя, или `-1`, если возвращается целое число (исключение: функции `PyArg_*()` возвращают `1` при успехе и `0` при ошибке). Когда функция должна завершиться ошибкой, потому что вызванная ей функция завершилась ошибкой, она обычно не устанавливает индикатор ошибки; его уже установила вызванная функция. Она отвечает либо за обработку ошибки и очистку исключения, либо за возврат после освобождения всех удерживаемых ресурсов (таких как ссылки на объекты или выделенная память); она *не* должна продолжать нормальное выполнение, если не готова обработать ошибку. При возврате из-за ошибки важно указать вызывающему коду, что ошибка была установлена. Если ошибка не обрабатывается или не аккуратно распространяется, последующие вызовы Python/C API могут вести себя не так, как задумано, и могут отказать загадочным образом. Индикатор ошибки состоит из трех объектов Python, соответствующих переменным Python `sys.exc_type`, `sys.exc_value` и `sys.exc_traceback`. Существуют функции API для взаимодействия с индикатором ошибки различными способами. Для каждого потока существует отдельный индикатор ошибки. **void `PyErr_PrintEx`(int *set\_sys\_last\_vars*)** Выводит стандартную трассировку в `sys.stderr` и очищает индикатор ошибки. Вызывайте эту функцию только при установленном индикаторе ошибки (иначе возникнет фатальная ошибка!). Если *set\_sys\_last\_vars* не равно нулю, переменные [`sys.last_type`](https://python-all.ru/2.6/library/sys.html#sys.last_type), [`sys.last_value`](https://python-all.ru/2.6/library/sys.html#sys.last_value) и [`sys.last_traceback`](https://python-all.ru/2.6/library/sys.html#sys.last_traceback) будут установлены в тип, значение и трассировку напечатанного исключения соответственно. **void `PyErr_Print`()** Псевдоним для `PyErr_PrintEx(1)` . **[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyErr_Occurred`()** *Возвращаемое значение: заимствованная ссылка.* Проверяет, установлен ли индикатор ошибки. Если установлен, возвращает *тип* исключения (первый аргумент последнего вызова одной из функций `PyErr_Set*()` или [`PyErr_Restore()`](https://python-all.ru/2.6/c-api/exceptions.html#PyErr_Restore)). Если не установлен, возвращает *NULL*. Вы не владеете ссылкой на возвращаемое значение, поэтому не нужно вызывать [`Py_DECREF()`](https://python-all.ru/2.6/c-api/refcounting.html#Py_DECREF). > **Примечание** > > Не сравнивайте возвращаемое значение с конкретным исключением; используйте [`PyErr_ExceptionMatches()`](https://python-all.ru/2.6/c-api/exceptions.html#PyErr_ExceptionMatches), как показано ниже. (Сравнение может легко завершиться неудачей, так как исключение может быть экземпляром, а не классом, в случае исключения-класса, или оно может быть подклассом ожидаемого исключения.) **int `PyErr_ExceptionMatches`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*exc*)** Эквивалентно `PyErr_GivenExceptionMatches(PyErr_Occurred(), exc)` . Функцию следует вызывать только тогда, когда исключение действительно установлено; в противном случае возникнет нарушение доступа к памяти. **int `PyErr_GivenExceptionMatches`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*given*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*exc*)** Возвращает истину, если исключение *given* соответствует исключению в *exc* . Если *exc* – объект класса, также возвращает истину, когда *given* является экземпляром подкласса. Если *exc* – кортеж, выполняется поиск совпадения по всем исключениям кортежа (и рекурсивно по вложенным кортежам). **void `PyErr_NormalizeException`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\*\*exc, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\*\*val, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\*\*tb)** При определённых обстоятельствах значения, возвращаемые [`PyErr_Fetch()`](https://python-all.ru/2.6/c-api/exceptions.html#PyErr_Fetch) (см. ниже), могут оказаться «ненормализованными»: `*exc` является объектом класса, но `*val` не является экземпляром того же класса. Данная функция позволяет инстанцировать класс в таком случае. Если значения уже нормализованы, ничего не происходит. Отложенная нормализация реализована для повышения производительности. **void `PyErr_Clear`()** Очищает индикатор ошибки. Если индикатор ошибки не установлен, эффекта нет. **void `PyErr_Fetch`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*\*ptype*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*\*pvalue*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*\*ptraceback*)** Извлекает индикатор ошибки в три переменные, адреса которых передаются. Если индикатор ошибки не установлен, устанавливает все три переменные в *NULL*. Если установлен, он будет очищен, и вы получаете владение ссылкой на каждый извлечённый объект. Значение и объект traceback могут быть *NULL*, даже если объект типа не NULL. > **Примечание** > > Эта функция обычно используется только кодом, которому нужно обрабатывать исключения, или кодом, которому требуется временно сохранить и восстановить индикатор ошибки. **void `PyErr_Restore`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*type*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*value*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*traceback*)** Set the error indicator from the three objects. If the error indicator is already set, it is cleared first. If the objects are *NULL*, the error indicator is cleared. Do not pass a *NULL* type and non-*NULL* value or traceback. The exception type should be a class. Do not pass an invalid exception type or value. (Violating these rules will cause subtle problems later.) This call takes away a reference to each object: you must own a reference to each object before the call and after the call you no longer own these references. (If you don’t understand this, don’t use this function. I warned you.) > **Примечание** > > Эта функция обычно используется только кодом, которому нужно временно сохранить и восстановить индикатор ошибки; для сохранения текущего состояния исключения используйте [`PyErr_Fetch()`](https://python-all.ru/2.6/c-api/exceptions.html#PyErr_Fetch). **void `PyErr_SetString`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*type*, const char *\*message*)** Это наиболее распространённый способ установки индикатора ошибки. Первый аргумент задаёт тип исключения; обычно это одно из стандартных исключений, например `PyExc_RuntimeError` . Увеличивать его счётчик ссылок не требуется. Второй аргумент – сообщение об ошибке; оно преобразуется в строковый объект. **void `PyErr_SetObject`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*type*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*value*)** Эта функция аналогична [`PyErr_SetString()`](https://python-all.ru/2.6/c-api/exceptions.html#PyErr_SetString) , но позволяет указать произвольный объект Python для параметра «value» исключения. **[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyErr_Format`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*exception*, const char *\*format*, ...)** *Возвращаемое значение: всегда NULL.* Эта функция устанавливает индикатор ошибки и возвращает *NULL*. *exception* должен быть исключением Python (классом, а не экземпляром). *format* должен быть строкой, содержащей коды форматирования, как в `printf()`. Перед кодом форматирования разбирается `width.precision`, но часть, задающая ширину, игнорируется. | Символы формата | Тип | Описание | | --- | --- | --- | | `%%` | *н/д* | Буквальный символ %. | | `%c` | int | Одиночный символ, представленный как C int. | | `%d` | int | Полностью эквивалентно `printf("%d")`. | | `%u` | беззнаковый int | Полностью эквивалентно `printf("%u")`. | | `%ld` | long | Полностью эквивалентно `printf("%ld")`. | | `%lu` | беззнаковый long | Полностью эквивалентно `printf("%lu")`. | | `%zd` | Py\_ssize\_t | Полностью эквивалентно `printf("%zd")`. | | `%zu` | size\_t | Полностью эквивалентно `printf("%zu")`. | | `%i` | int | Полностью эквивалентно `printf("%i")`. | | `%x` | int | Полностью эквивалентно `printf("%x")`. | | `%s` | char\* | Нуль-терминированный массив символов C. | | `%p` | void\* | Шестнадцатеричное представление указателя C. В основном эквивалентно `printf("%p")` за исключением того, что гарантированно начинается с литерала `0x` независимо от того, что выдает `printf` на данной платформе. | Нераспознанный символ формата приводит к тому, что вся оставшаяся строка формата копируется как есть в результирующую строку, а все лишние аргументы отбрасываются. **void `PyErr_SetNone`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*type*)** Это сокращённая запись для `PyErr_SetObject(type, Py_None)` . **int `PyErr_BadArgument`()** Это сокращённая запись для `PyErr_SetString(PyExc_TypeError, message)` , где *message* указывает, что встроенная операция была вызвана с недопустимым аргументом. В основном используется внутри. **[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyErr_NoMemory`()** *Возвращаемое значение: всегда NULL.* Это сокращённая запись для `PyErr_SetNone(PyExc_MemoryError)`; она возвращает *NULL*, чтобы функция выделения объекта могла написать `return PyErr_NoMemory();` при нехватке памяти. **[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyErr_SetFromErrno`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*type*)** *Возвращаемое значение: всегда NULL.* Это вспомогательная функция для возбуждения исключения, когда функция библиотеки C вернула ошибку и установила переменную C `errno`. Она создаёт объект-кортеж, первый элемент которого – целое значение `errno`, а второй – соответствующее сообщение об ошибке (полученное через `strerror()`), и затем вызывает `PyErr_SetObject(type, object)`. В Unix, когда значение `errno` равно `EINTR`, что указывает на прерванный системный вызов, эта функция вызывает [`PyErr_CheckSignals()`](https://python-all.ru/2.6/c-api/exceptions.html#PyErr_CheckSignals), и если тот установил индикатор ошибки, оставляет его таким. Функция всегда возвращает *NULL*, поэтому обёрточная функция вокруг системного вызова может написать `return PyErr_SetFromErrno(type);` когда системный вызов возвращает ошибку. **[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyErr_SetFromErrnoWithFilename`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*type*, const char *\*filename*)** *Возвращаемое значение: всегда NULL.* Похожа на [`PyErr_SetFromErrno()`](https://python-all.ru/2.6/c-api/exceptions.html#PyErr_SetFromErrno), с дополнительным поведением: если *filename* не равен *NULL*, он передаётся конструктору *type* в качестве третьего параметра. Для таких исключений, как [`IOError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.IOError) и [`OSError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.OSError), это используется для определения атрибута `filename` экземпляра исключения. **[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyErr_SetFromWindowsErr`(int *ierr*)** *Возвращаемое значение: всегда NULL.* Это вспомогательная функция для возбуждения [`WindowsError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.WindowsError). Если вызвана с *ierr* равным `0`, используется код ошибки, возвращённый вызовом `GetLastError()`. Она вызывает функцию Win32 `FormatMessage()`, чтобы получить описание Windows для кода ошибки, заданного *ierr* или `GetLastError()`, затем создаёт объект-кортеж, первый элемент которого – значение *ierr*, а второй – соответствующее сообщение об ошибке (полученное через `FormatMessage()`), и затем вызывает `PyErr_SetObject(PyExc_WindowsError, object)`. Эта функция всегда возвращает *NULL*. Доступность: Windows. **[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyErr_SetExcFromWindowsErr`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*type*, int *ierr*)** *Возвращаемое значение: всегда NULL.* Аналогично [`PyErr_SetFromWindowsErr()`](https://python-all.ru/2.6/c-api/exceptions.html#PyErr_SetFromWindowsErr), с дополнительным параметром, указывающим тип возбуждаемого исключения. Доступность: Windows. Новое в версии 2.3. **[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyErr_SetFromWindowsErrWithFilename`(int *ierr*, const char *\*filename*)** *Возвращаемое значение: всегда NULL.* Похожа на [`PyErr_SetFromWindowsErr()`](https://python-all.ru/2.6/c-api/exceptions.html#PyErr_SetFromWindowsErr), с дополнительным поведением: если *filename* не равен *NULL*, он передаётся конструктору [`WindowsError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.WindowsError) в качестве третьего параметра. Доступность: Windows. **[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyErr_SetExcFromWindowsErrWithFilename`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*type*, int *ierr*, char *\*filename*)** *Возвращаемое значение: всегда NULL.* Аналогично [`PyErr_SetFromWindowsErrWithFilename()`](https://python-all.ru/2.6/c-api/exceptions.html#PyErr_SetFromWindowsErrWithFilename), с дополнительным параметром, указывающим тип возбуждаемого исключения. Доступность: Windows. Новое в версии 2.3. **void `PyErr_BadInternalCall`()** Это сокращённая форма для `PyErr_SetString(PyExc_SystemError, message)` , где *message* указывает, что внутренняя операция (например, функция Python/C API) была вызвана с недопустимым аргументом. В основном используется внутри. **int `PyErr_WarnEx`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*category*, char *\*message*, int *stacklevel*)** Выдаёт предупреждение. Аргумент *category* – это категория предупреждения (см. ниже) или *NULL*; аргумент *message* – строка сообщения. *stacklevel* – положительное число, задающее количество кадров стека; предупреждение будет выдано из строки кода, выполняющейся в этом кадре стека. *stacklevel*, равный 1, соответствует функции, вызывающей [`PyErr_WarnEx()`](https://python-all.ru/2.6/c-api/exceptions.html#PyErr_WarnEx), 2 – функции, вызвавшей её, и так далее. Обычно эта функция выводит предупреждение в *sys.stderr*; однако возможно, что пользователь указал превращать предупреждения в ошибки, и в этом случае будет вызвано исключение. Также возможно, что функция вызывает исключение из-за проблемы в механизме предупреждений (реализация импортирует модуль [`warnings`](https://python-all.ru/2.6/library/warnings.html#module-warnings) для выполнения основной работы). Возвращаемое значение – `0`, если исключение не возникло, или `-1`, если возникло. (Невозможно определить, было ли предупреждение фактически выведено, а также причину исключения; это сделано намеренно.) Если возникло исключение, вызывающий код должен выполнить обычную обработку исключений (например, [`Py_DECREF()`](https://python-all.ru/2.6/c-api/refcounting.html#Py_DECREF) для владеемых ссылок и вернуть значение ошибки). Категории предупреждений должны быть подклассами `Warning`; категория предупреждения по умолчанию – `RuntimeWarning`. Стандартные категории предупреждений Python доступны как глобальные переменные, имена которых – `PyExc_`, за которым следует имя исключения Python. Они имеют тип [`PyObject*`](https://python-all.ru/2.6/c-api/structures.html#PyObject); все они являются объектами классов. Их имена: `PyExc_Warning`, `PyExc_UserWarning`, `PyExc_UnicodeWarning`, `PyExc_DeprecationWarning`, `PyExc_SyntaxWarning`, `PyExc_RuntimeWarning` и `PyExc_FutureWarning`. `PyExc_Warning` является подклассом `PyExc_Exception`; остальные категории предупреждений являются подклассами `PyExc_Warning`. Информацию об управлении предупреждениями см. в документации модуля [`warnings`](https://python-all.ru/2.6/library/warnings.html#module-warnings) и опции [*-W*](https://python-all.ru/2.6/using/cmdline.html#cmdoption-W) в документации командной строки. C API для управления предупреждениями не существует. **int `PyErr_Warn`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*category*, char *\*message*)** Выдаёт предупреждающее сообщение. Аргумент *category* – это категория предупреждения (см. ниже) или *NULL*; аргумент *message* – строка сообщения. Предупреждение будет выглядеть так, как будто оно выдано функцией, вызывающей [`PyErr_Warn()`](https://python-all.ru/2.6/c-api/exceptions.html#PyErr_Warn), что эквивалентно вызову [`PyErr_WarnEx()`](https://python-all.ru/2.6/c-api/exceptions.html#PyErr_WarnEx) с *stacklevel*, равным 1. Устарело; используйте [`PyErr_WarnEx()`](https://python-all.ru/2.6/c-api/exceptions.html#PyErr_WarnEx) вместо этого. **int `PyErr_WarnExplicit`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*category*, const char *\*message*, const char *\*filename*, int *lineno*, const char *\*module*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*registry*)** Выдаёт предупреждение с явным контролем всех атрибутов предупреждения. Это простая обёртка вокруг функции Python [`warnings.warn_explicit()`](https://python-all.ru/2.6/library/warnings.html#warnings.warn_explicit) , см. описание там. Аргументы *module* и *registry* могут быть установлены в *NULL* для получения эффекта по умолчанию, как описано там. **int `PyErr_WarnPy3k`(char *\*message*, int *stacklevel*)** Выдаёт [`DeprecationWarning`](https://python-all.ru/2.6/library/exceptions.html#exceptions.DeprecationWarning) с заданными *message* и *stacklevel*, если флаг `Py_Py3kWarningFlag` включён. Новое в версии 2.6. **int `PyErr_CheckSignals`()** Эта функция взаимодействует с обработкой сигналов Python. Она проверяет, был ли отправлен сигнал процессам, и если да, вызывает соответствующий обработчик сигнала. Если модуль [`signal`](https://python-all.ru/2.6/library/signal.html#module-signal) поддерживается, может быть вызван обработчик сигнала, написанный на Python. Во всех случаях действие по умолчанию для `SIGINT` – возбуждение исключения [`KeyboardInterrupt`](https://python-all.ru/2.6/library/exceptions.html#exceptions.KeyboardInterrupt). Если исключение возбуждено, устанавливается индикатор ошибки, и функция возвращает `-1`; в противном случае функция возвращает `0`. Индикатор ошибки может быть сброшен или не сброшен, если он был установлен ранее. **void `PyErr_SetInterrupt`()** Эта функция имитирует поступление сигнала `SIGINT` – при следующем вызове [`PyErr_CheckSignals()`](https://python-all.ru/2.6/c-api/exceptions.html#PyErr_CheckSignals) будет возбуждено исключение [`KeyboardInterrupt`](https://python-all.ru/2.6/library/exceptions.html#exceptions.KeyboardInterrupt). Может быть вызвана без захвата блокировки интерпретатора. **int `PySignal_SetWakeupFd`(int *fd*)** Эта вспомогательная функция задаёт файловый дескриптор, в который будет записан байт `'\0'` при получении сигнала. Возвращает предыдущий такой файловый дескриптор. Значение `-1` отключает эту возможность; это начальное состояние. Эквивалентно [`signal.set_wakeup_fd()`](https://python-all.ru/2.6/library/signal.html#signal.set_wakeup_fd) в Python, но без проверки ошибок. *fd* должен быть корректным файловым дескриптором. Функцию следует вызывать только из главного потока. **[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyErr_NewException`(char *\*name*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*base*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*dict*)** *Возвращаемое значение: новая ссылка.* Эта вспомогательная функция создаёт и возвращает новый объект исключения. Аргумент *name* должен задавать имя нового исключения – строку C в формате `module.class`. Аргументы *base* и *dict* обычно равны *NULL*. Функция создаёт объект класса, производного от [`Exception`](https://python-all.ru/2.6/library/exceptions.html#exceptions.Exception) (на C доступен как `PyExc_Exception`). Атрибут `__module__` нового класса устанавливается в первую часть (до последней точки) аргумента *name*, а имя класса – в последнюю часть (после последней точки). Аргумент *base* можно использовать для указания альтернативных базовых классов; это может быть как один класс, так и кортеж классов. Аргумент *dict* можно использовать для указания словаря переменных и методов класса. **void `PyErr_WriteUnraisable`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*obj*)** Эта вспомогательная функция выводит предупреждение в `sys.stderr`, когда исключение установлено, но интерпретатор не может его фактически возбудить. Используется, например, когда исключение возникает в методе [`__del__()`](https://python-all.ru/2.6/reference/datamodel.html#object.__del__). Функция вызывается с одним аргументом *obj*, который идентифицирует контекст, в котором возникло не вызываемое исключение. В сообщении предупреждения будет выведено repr от *obj*. ## Управление рекурсией Эти две функции предоставляют способ выполнения безопасных рекурсивных вызовов на уровне C как в ядре, так и в модулях расширения. Они необходимы, если рекурсивный код не обязательно вызывает код Python (который автоматически отслеживает свою глубину рекурсии). **int `Py_EnterRecursiveCall`(char *\*where*)** Отмечает точку, в которой будет выполнен рекурсивный вызов на уровне C. Если определён `USE_STACKCHECK`, эта функция проверяет, не переполнился ли стек ОС, с помощью [`PyOS_CheckStack()`](https://python-all.ru/2.6/c-api/sys.html#PyOS_CheckStack). Если это так, она устанавливает [`MemoryError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.MemoryError) и возвращает ненулевое значение. Затем функция проверяет, достигнут ли лимит рекурсии. Если это так, устанавливается [`RuntimeError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.RuntimeError) и возвращается ненулевое значение. В противном случае возвращается ноль. *where* должна быть строкой, например `" in instance check"`, которая будет добавлена к сообщению [`RuntimeError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.RuntimeError), вызванному пределом глубины рекурсии. **void `Py_LeaveRecursiveCall`()** Завершает [`Py_EnterRecursiveCall()`](https://python-all.ru/2.6/c-api/exceptions.html#Py_EnterRecursiveCall) . Должен вызываться один раз для каждого *успешного* вызова [`Py_EnterRecursiveCall()`](https://python-all.ru/2.6/c-api/exceptions.html#Py_EnterRecursiveCall) . ## Стандартные исключения Все стандартные исключения Python доступны как глобальные переменные, имена которых состоят из `PyExc_`, за которым следует имя исключения Python. Они имеют тип [`PyObject*`](https://python-all.ru/2.6/c-api/structures.html#PyObject); все они являются объектами классов. Для полноты картины, вот все переменные: | Имя в C | Имя в Python | Примечания | | --- | --- | --- | | `PyExc_BaseException` | [`BaseException`](https://python-all.ru/2.6/library/exceptions.html#exceptions.BaseException) | (1), (4) | | `PyExc_Exception` | [`исключение`](https://python-all.ru/2.6/library/exceptions.html#exceptions.Exception) | (1) | | `PyExc_StandardError` | [`StandardError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.StandardError) | (1) | | `PyExc_ArithmeticError` | [`ArithmeticError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.ArithmeticError) | (1) | | `PyExc_LookupError` | [`LookupError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.LookupError) | (1) | | `PyExc_AssertionError` | [`AssertionError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.AssertionError) | | | `PyExc_AttributeError` | [`AttributeError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.AttributeError) | | | `PyExc_EOFError` | [`EOFError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.EOFError) | | | `PyExc_EnvironmentError` | [`EnvironmentError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.EnvironmentError) | (1) | | `PyExc_FloatingPointError` | [`FloatingPointError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.FloatingPointError) | | | `PyExc_IOError` | [`IOError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.IOError) | | | `PyExc_ImportError` | [`ImportError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.ImportError) | | | `PyExc_IndexError` | [`IndexError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.IndexError) | | | `PyExc_KeyError` | [`KeyError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.KeyError) | | | `PyExc_KeyboardInterrupt` | [`KeyboardInterrupt`](https://python-all.ru/2.6/library/exceptions.html#exceptions.KeyboardInterrupt) | | | `PyExc_MemoryError` | [`MemoryError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.MemoryError) | | | `PyExc_NameError` | [`NameError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.NameError) | | | `PyExc_NotImplementedError` | [`NotImplementedError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.NotImplementedError) | | | `PyExc_OSError` | [`OSError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.OSError) | | | `PyExc_OverflowError` | [`OverflowError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.OverflowError) | | | `PyExc_ReferenceError` | [`ReferenceError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.ReferenceError) | (2) | | `PyExc_RuntimeError` | [`RuntimeError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.RuntimeError) | | | `PyExc_SyntaxError` | [`SyntaxError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.SyntaxError) | | | `PyExc_SystemError` | [`SystemError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.SystemError) | | | `PyExc_SystemExit` | [`SystemExit`](https://python-all.ru/2.6/library/exceptions.html#exceptions.SystemExit) | | | `PyExc_TypeError` | [`TypeError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.TypeError) | | | `PyExc_ValueError` | [`ValueError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.ValueError) | | | `PyExc_WindowsError` | [`WindowsError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.WindowsError) | (3) | | `PyExc_ZeroDivisionError` | [`ZeroDivisionError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.ZeroDivisionError) | | Примечания: 1. Это базовый класс для других стандартных исключений. 2. То же самое, что [`weakref.ReferenceError`](https://python-all.ru/2.6/library/weakref.html#weakref.ReferenceError). 3. Определён только в Windows; код, использующий это, должен проверять, определён ли макрос препроцессора `MS_WINDOWS`. 4. Новое в версии 2.5. ## Устаревание строковых исключений Все исключения, встроенные в Python или предоставляемые стандартной библиотекой, происходят от [`BaseException`](https://python-all.ru/2.6/library/exceptions.html#exceptions.BaseException). Строковые исключения по-прежнему поддерживаются в интерпретаторе, чтобы существующий код мог выполняться без изменений, но это также изменится в будущем релизе.