> **Источник:** https://python-all.ru/3.0/library/sys.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# `sys` – Системно-зависимые параметры и функции

Этот модуль предоставляет доступ к некоторым переменным, используемым или поддерживаемым интерпретатором, и к функциям, которые активно взаимодействуют с интерпретатором. Он всегда доступен.

#### `[sys.argv]sys.argv`

Список аргументов командной строки, переданных скрипту Python. `argv[0]` – это имя скрипта (зависит от операционной системы, является ли это полным именем пути или нет). Если команда была выполнена с использованием опции командной строки [*-c*](https://python-all.ru/3.0/using/cmdline.html#cmdoption-c) интерпретатора, `argv[0]` устанавливается в строку `'-c'`. Если имя скрипта не было передано интерпретатору Python, `argv[0]` является пустой строкой.

Для итерации по стандартному вводу или списку файлов, переданных в командной строке, обратитесь к модулю [`fileinput`](https://python-all.ru/3.0/library/fileinput.html#module-fileinput).

#### `[sys.byteorder]sys.byteorder`

Индикатор естественного порядка байтов. Значение равно

`'big'`

на платформах с обратным порядком (от старшего байта к младшему) и

`'little'`

на платформах с прямым порядком (от младшего байта к старшему).

#### `[sys.subversion]sys.subversion`

Тройка (repo, branch, version), представляющая информацию Subversion об интерпретаторе Python.

*repo*

– имя репозитория,

`'CPython'`

.

*branch*

– строка одного из видов

`'trunk'`

,

`'branches/name'`

или

`'tags/name'`

.

*version*

– вывод

`svnversion`

, если интерпретатор был собран из Subversion-рабочей копии; он содержит номер ревизии (диапазон) и, возможно, завершающую букву ‘M’, если были локальные изменения. Если дерево было экспортировано (или svnversion недоступен), то это ревизия

`Include/patchlevel.h`

, если ветка является тегом. В противном случае –

`None`

.

#### `[sys.builtin_module_names]sys.builtin_module_names`

Кортеж строк с именами всех модулей, вкомпилированных в данный интерпретатор Python. (Эту информацию нельзя получить иным способом –

`modules.keys()`

перечисляет только импортированные модули.)

#### `[sys.copyright]sys.copyright`

Строка, содержащая сведения об авторских правах на интерпретатор Python.

#### `[sys._clear_type_cache]sys._clear_type_cache()`

Очищает внутренний кеш типов. Кеш типов используется для ускорения поиска атрибутов и методов. Эту функцию следует использовать *только* для удаления лишних ссылок при отладке утечек ссылок.

Эту функцию следует использовать только для внутренних и специальных целей.

#### `[sys._current_frames]sys._current_frames()`

Возвращает словарь, сопоставляющий идентификатор каждого потока самому верхнему фрейму стека, активному в этом потоке на момент вызова функции. Обратите внимание, что функции модуля [`traceback`](https://python-all.ru/3.0/library/traceback.html#module-traceback) могут построить стек вызовов, имея такой фрейм.

Это особенно полезно для отладки взаимоблокировок: эта функция не требует содействия заблокированных потоков, и стеки вызовов таких потоков заморожены, пока они остаются заблокированными. Кадр, возвращённый для незаблокированного потока, может не соответствовать текущей активности этого потока, когда вызывающий код изучает кадр.

Эту функцию следует использовать только для внутренних и специальных целей.

#### `[sys.dllhandle]sys.dllhandle`

Целое число, определяющее дескриптор DLL Python. Доступность: Windows.

#### `[sys.displayhook]sys.displayhook(value)`

Если *value* не равно `None`, эта функция выводит его в `sys.stdout` и сохраняет в `builtins._`.

`sys.displayhook` вызывается для результата вычисления [*выражения*](https://python-all.ru/3.0/glossary.html#term-expression), введённого в интерактивном сеансе Python. Отображение этих значений можно настроить, назначив другую функцию с одним аргументом на `sys.displayhook`.

#### `[sys.excepthook]sys.excepthook(type, value, traceback)`

Эта функция выводит заданный traceback и исключение в `sys.stderr`.

Когда возникает неперехваченное исключение, интерпретатор вызывает `sys.excepthook` с тремя аргументами: классом исключения, экземпляром исключения и объектом traceback. В интерактивном сеансе это происходит непосредственно перед возвратом управления к приглашению; в программе Python это происходит непосредственно перед выходом программы. Обработку таких исключений верхнего уровня можно настроить, назначив другую функцию с тремя аргументами на `sys.excepthook`.

#### `[sys.__displayhook__]sys.__displayhook__`

#### `sys.__excepthook__`

Эти объекты содержат исходные значения

`displayhook`

и

`excepthook`

в начале программы. Они сохраняются, чтобы

`displayhook`

и

`excepthook`

можно было восстановить, если они случайно будут заменены сломанными объектами.

#### `[sys.exc_info]sys.exc_info()`

Эта функция возвращает кортеж из трёх значений, содержащих информацию об обрабатываемом в данный момент исключении. Возвращаемая информация относится как к текущему потоку, так и к текущему фрейму стека. Если текущий фрейм стека не обрабатывает исключение, информация берётся из вызывающего фрейма стека или его вызывающего, и так далее, пока не будет найден фрейм, обрабатывающий исключение. Здесь «обработка исключения» означает «выполнение блока except». Для любого фрейма стека доступна только информация об исключении, обрабатываемом в данный момент.

Если нигде в стеке не обрабатывается исключение, возвращается кортеж из трёх значений `None`. В противном случае возвращаются значения `(type, value, traceback)`. Их смысл: *type* содержит тип обрабатываемого исключения (объект класса); *value* содержит параметр исключения (его *связанное значение* или второй аргумент [`raise`](https://python-all.ru/3.0/reference/simple_stmts.html#raise), который всегда является экземпляром класса, если тип исключения – объект класса); *traceback* содержит объект трассировки (см. справочное руководство), который инкапсулирует стек вызовов в точке, где изначально произошло исключение.

> **Предупреждение**
>
> Присваивание возвращаемого значения *traceback* локальной переменной в функции, обрабатывающей исключение, приведёт к циклической ссылке. Поскольку большинству функций не нужен доступ к traceback, лучшим решением будет использовать что-то вроде `exctype, value = sys.exc_info()[:2]`, чтобы извлечь только тип и значение исключения. Если же traceback всё-таки нужен, обязательно удалите его после использования (лучше всего это сделать с помощью оператора [`try`](https://python-all.ru/3.0/reference/compound_stmts.html#try) ... [`finally`](https://python-all.ru/3.0/reference/compound_stmts.html#finally)) или вызовите [`exc_info()`](https://python-all.ru/3.0/library/sys.html#sys.exc_info) в функции, которая сама не обрабатывает исключение.
>
> Такие циклы обычно автоматически удаляются, когда сборка мусора включена и они становятся недостижимыми, но всё же более эффективно избегать создания циклов.

#### `[sys.exec_prefix]sys.exec_prefix`

Строка, содержащая префикс каталога, специфичный для сайта, в который устанавливаются платформозависимые файлы Python; по умолчанию это также

`'/usr/local'`

. Это можно задать во время сборки с помощью аргумента

*--exec-prefix*

скрипта

**configure**

. В частности, все конфигурационные файлы (например, заголовочный файл

`pyconfig.h`

) устанавливаются в каталог

`exec_prefix + '/lib/pythonversion/config'`

, а модули разделяемых библиотек устанавливаются в

`exec_prefix + '/lib/pythonversion/lib-dynload'`

, где

*version*

равно

`version[:3]`

.

#### `[sys.executable]sys.executable`

Строка, содержащая имя исполняемого двоичного файла интерпретатора Python, на системах, где это имеет смысл.

#### `[sys.exit]sys.exit([arg])`

Выход из Python. Реализуется возбуждением исключения

[`SystemExit`](https://python-all.ru/3.0/library/exceptions.html#exceptions.SystemExit)

, так что действия по очистке, заданные в предложениях finally конструкций

[`try`](https://python-all.ru/3.0/reference/compound_stmts.html#try)

, выполняются, и попытку выхода можно перехватить на внешнем уровне. Необязательный аргумент

*arg*

может быть целым числом, задающим статус выхода (по умолчанию ноль), или объектом другого типа. Если это целое число, ноль считается «успешным завершением», а любое ненулевое значение – «аварийным завершением» в оболочках и тому подобном. Большинство систем требуют, чтобы оно было в диапазоне 0–127, иначе результат не определён. В некоторых системах существуют соглашения о присвоении определённых значений определённым кодам выхода, но они, как правило, слабо развиты; программы Unix обычно используют 2 для ошибок синтаксиса командной строки и 1 для всех остальных видов ошибок. Если передан объект другого типа,

`None`

эквивалентен передаче нуля, а любой другой объект выводится в

`sys.stderr`

и приводит к коду выхода 1. В частности,

`sys.exit("some error message")`

– быстрый способ выйти из программы при возникновении ошибки.

#### `[sys.flags]sys.flags`

Структурная последовательность *flags* показывает состояние флагов командной строки. Атрибуты доступны только для чтения.

| атрибут | флаг |
| --- | --- |
| `отладка` | -d |
| `py3k_warning` | -3 |
| `division_warning` | -Q |
| `division_new` | -Qnew |
| `inspect` | -i |
| `интерактивный` | -i |
| `optimize` | -O or -OO |
| [`dont_write_bytecode`](https://python-all.ru/3.0/library/sys.html#sys.dont_write_bytecode) | -B |
| `no_site` | -S |
| `ignore_environment` | -E |
| `verbose` | -v |
| `unicode` | -U |

#### `[sys.float_info]sys.float_info`

Структура structseq, содержащая информацию о типе float. Включает низкоуровневые\\nсведения о точности и внутреннем представлении. Для получения дополнительной\\nинформации изучите файл `float.h` вашей системы.

| атрибут | объяснение |
| --- | --- |
| `epsilon` | Разница между 1 и следующим представимым\\nчислом с плавающей точкой. |
| `dig` | цифры (см. `float.h`) |
| `mant_dig` | цифры мантиссы (см. `float.h`) |
| [`max`](https://python-all.ru/3.0/library/functions.html#max) | максимальное представимое конечное число типа float |
| `max_exp` | максимальное целое e, такое что radix\*\*(e-1) находится в\\nдиапазоне конечных представимых чисел с плавающей точкой. |
| `max_10_exp` | максимальное целое e, такое что 10\*\*e находится в\\nдиапазоне конечных представимых чисел с плавающей точкой. |
| [`min`](https://python-all.ru/3.0/library/functions.html#min) | Минимальное положительное нормализованное число с плавающей точкой. |
| `min_exp` | минимальное целое e, такое что radix\*\*(e-1) является\\nнормализованным числом с плавающей точкой. |
| `min_10_exp` | минимальное целое e, такое что 10\*\*e является\\nнормализованным числом с плавающей точкой. |
| `основание системы счисления` | радикс экспоненты |
| `режим округления` | режимы округления при сложении (см. `float.h`) |

> **Примечание**
>
> Информация в таблице упрощена.

#### `[sys.getcheckinterval]sys.getcheckinterval()`

Возвращает «интервал проверки» интерпретатора; см.

[`setcheckinterval()`](https://python-all.ru/3.0/library/sys.html#sys.setcheckinterval)

.

#### `[sys.getdefaultencoding]sys.getdefaultencoding()`

Возвращает имя текущей кодировки строк по умолчанию, используемой реализацией Unicode.

#### `[sys.getdlopenflags]sys.getdlopenflags()`

Возвращает текущее значение флагов, используемых для вызовов

`dlopen`

. Константы флагов определены в модулях

[`ctypes`](https://python-all.ru/3.0/library/ctypes.html#module-ctypes)

и

`DLFCN`

. Доступность: Unix.

#### `[sys.getfilesystemencoding]sys.getfilesystemencoding()`

Возвращает имя кодировки, используемой для преобразования имён файлов в Unicode в системные имена файлов, или `None`, если используется системная кодировка по умолчанию. Результирующее значение зависит от операционной системы:

- В Windows 9x используется кодировка «mbcs».
- В Mac OS X используется кодировка «utf-8».
- В Unix кодировка определяется предпочтениями пользователя в соответствии с результатом nl\_langinfo(CODESET) или [`None`](https://python-all.ru/3.0/library/constants.html#None), если вызов `nl_langinfo(CODESET)` завершился неудачей.
- В Windows NT+ имена файлов изначально хранятся в Unicode, поэтому преобразование не выполняется. [`getfilesystemencoding()`](https://python-all.ru/3.0/library/sys.html#sys.getfilesystemencoding) по-прежнему возвращает `'mbcs'`, так как это кодировка, которую приложения должны использовать, когда они явно хотят преобразовать строки Unicode в байтовые строки, эквивалентные при использовании в качестве имён файлов.

#### `[sys.getrefcount]sys.getrefcount(object)`

Возвращает счетчик ссылок объекта

*object*

. Возвращаемое значение обычно на единицу больше ожидаемого, поскольку включает (временную) ссылку на объект в качестве аргумента

[`getrefcount()`](https://python-all.ru/3.0/library/sys.html#sys.getrefcount)

.

#### `[sys.getrecursionlimit]sys.getrecursionlimit()`

Возвращает текущее значение предела рекурсии – максимальной глубины стека интерпретатора Python. Этот предел предотвращает переполнение C-стека и аварийное завершение Python из-за бесконечной рекурсии. Его можно задать с помощью

[`setrecursionlimit()`](https://python-all.ru/3.0/library/sys.html#sys.setrecursionlimit)

.

#### `[sys.getsizeof]sys.getsizeof(object[, default])`

Возвращает размер объекта в байтах. Объект может быть любого типа. Все встроенные объекты возвращают корректные результаты, но для сторонних расширений это не обязательно – результат зависит от реализации.

Аргумент *default* позволяет задать значение, которое будет возвращено, если тип объекта не предоставляет способа получить размер и это привело бы к *TypeError*.

func:*getsizeof* вызывает метод \_\_sizeof\_\_ объекта и добавляет дополнительные накладные расходы на сборщик мусора, если объект управляется сборщиком мусора.

#### `[sys._getframe]sys._getframe([depth])`

Возвращает объект фрейма из стека вызовов. Если указан необязательный целочисленный параметр *depth*, возвращается объект фрейма, находящийся на указанное количество вызовов ниже вершины стека. Если это глубже, чем стек вызовов, возбуждается [`ValueError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.ValueError). Значение по умолчанию для *depth* равно нулю, при этом возвращается фрейм на вершине стека вызовов.

Эту функцию следует использовать только для внутренних и специальных целей.

#### `[sys.getprofile]sys.getprofile()`

Возвращает функцию профилировщика, установленную с помощью [`setprofile()`](https://python-all.ru/3.0/library/sys.html#sys.setprofile).

#### `[sys.gettrace]sys.gettrace()`

Возвращает функцию трассировки, установленную с помощью [`settrace()`](https://python-all.ru/3.0/library/sys.html#sys.settrace).

> **Примечание**
>
> Функция [`gettrace()`](https://python-all.ru/3.0/library/sys.html#sys.gettrace) предназначена только для реализации отладчиков, профилировщиков, инструментов покрытия кода и тому подобного. Её поведение является частью конкретной реализации платформы, а не частью определения языка, и поэтому может быть недоступна во всех реализациях Python.

#### `[sys.getwindowsversion]sys.getwindowsversion()`

Возвращает кортеж из пяти компонентов, описывающих версию Windows, работающую в данный момент. Элементы: *major*, *minor*, *build*, *platform* и *text*. *text* содержит строку, а все остальные значения – целые числа.

*platform* может принимать одно из следующих значений:

| Константа | Платформа |
| --- | --- |
| `0 (VER_PLATFORM_WIN32s)` | Win32s на Windows 3.1 |
| `1 (VER_PLATFORM_WIN32_WINDOWS)` | Windows 95/98/ME |
| `2 (VER_PLATFORM_WIN32_NT)` | Windows NT/2000/XP/x64 |
| `3 (VER_PLATFORM_WIN32_CE)` | Windows CE |

Эта функция является обёрткой над функцией Win32 `GetVersionEx`; обратитесь к документации Microsoft за дополнительной информацией об этих полях.

Доступность: Windows.

#### `[sys.hexversion]sys.hexversion`

Номер версии, закодированный в виде одного целого числа. Гарантируется, что он увеличивается с каждой версией, включая надлежащую поддержку непроизводственных выпусков. Например, чтобы проверить, что интерпретатор Python имеет версию не ниже 1.5.2, используйте:

```python
if sys.hexversion >= 0x010502F0:
    # используйте некоторую продвинутую функцию
    ...
else:
    # используйте альтернативную реализацию или предупредите пользователя
    ...
```

Она называется `hexversion`, потому что действительно выглядит осмысленно только при передаче встроенной функции [`hex()`](https://python-all.ru/3.0/library/functions.html#hex). Значение `version_info` можно использовать для более понятного человеку представления той же информации.

#### `[sys.intern]sys.intern(string)`

Помещает *строку* в таблицу «интернированных» строк и возвращает интернированную строку – *строку* (ту же самую или копию). Интернирование строк полезно для небольшого повышения производительности поиска в словаре: если ключи в словаре интернированы и искомый ключ интернирован, сравнение ключей (после хеширования) может выполняться сравнением указателей, а не строк. Обычно имена, используемые в программах Python, автоматически интернируются, и словари, используемые для хранения атрибутов модулей, классов или экземпляров, имеют интернированные ключи.

Интернированные строки не бессмертны; необходимо сохранять ссылку на возвращаемое значение [`intern()`](https://python-all.ru/3.0/library/sys.html#sys.intern), чтобы пользоваться преимуществами интернирования.

#### `[sys.last_type]sys.last_type`

#### `sys.last_value`

#### `sys.last_traceback`

Эти три переменные определены не всегда: они устанавливаются, когда исключение не обработано и интерпретатор печатает сообщение об ошибке и трассировку стека. Их назначение – дать возможность интерактивному пользователю импортировать модуль отладчика и заняться посмертной отладкой без необходимости повторного выполнения команды, вызвавшей ошибку. (Типичное использование – `import pdb; pdb.pm()` для входа в посмертный отладчик; см. главу [*pdb – Отладчик Python*](https://python-all.ru/3.0/library/pdb.html#debugger) для получения дополнительной информации.)

Смысл этих переменных совпадает со смыслом возвращаемых значений из [`exc_info()`](https://python-all.ru/3.0/library/sys.html#sys.exc_info) выше. (Поскольку существует только один интерактивный поток, потокобезопасность не является проблемой для этих переменных, в отличие от `exc_type` и т.д.)

#### `[sys.maxsize]sys.maxsize`

Целое число, показывающее максимальное значение, которое может принимать переменная типа

`Py_ssize_t`

. Обычно это

`2**31 - 1`

на 32-битной платформе и

`2**63 - 1`

на 64-битной.

#### `[sys.maxunicode]sys.maxunicode`

Целое число, задающее наибольший поддерживаемый код символа Unicode. Его значение зависит от параметра конфигурации, указывающего, хранятся ли символы Unicode как UCS-2 или UCS-4.

#### `[sys.modules]sys.modules`

Это словарь, который сопоставляет имена модулей с уже загруженными модулями. Его можно использовать для принудительной перезагрузки модулей и других трюков.

#### `[sys.path]sys.path`

Список строк, задающих пути поиска модулей. Инициализируется из переменной окружения [**PYTHONPATH**](https://python-all.ru/3.0/using/cmdline.html#envvar-PYTHONPATH), дополненной значением по умолчанию, зависящим от установки.

При запуске программы первый элемент этого списка, `path[0]`, содержит каталог со скриптом, который использовался для запуска интерпретатора Python. Если каталог скрипта недоступен (например, при интерактивном запуске интерпретатора или чтении скрипта со стандартного ввода), `path[0]` представляет собой пустую строку, что заставляет Python искать модули сначала в текущем каталоге. Обратите внимание, что каталог скрипта добавляется *перед* записями, добавляемыми в результате [**PYTHONPATH**](https://python-all.ru/3.0/using/cmdline.html#envvar-PYTHONPATH).

Программа может свободно изменять этот список для своих целей.

> **См. также**
>
> Модуль [`site`](https://python-all.ru/3.0/library/site.html#module-site) описывает, как использовать .pth-файлы для расширения [`sys.path`](https://python-all.ru/3.0/library/sys.html#sys.path).

#### `[sys.platform]sys.platform`

Эта строка содержит идентификатор платформы, который можно использовать, например, для добавления платформозависимых компонентов в [`sys.path`](https://python-all.ru/3.0/library/sys.html#sys.path).

Для систем Unix это имя ОС в нижнем регистре, возвращаемое командой `uname -s`, с добавленной первой частью версии, возвращаемой командой `uname -r`, например `'sunos5'` или `'linux2'`, *на момент сборки Python*. Для других систем значения таковы:

| Система | [`platform`](https://python-all.ru/3.0/library/sys.html#sys.platform) значение |
| --- | --- |
| Windows | `'win32'` |
| Windows/Cygwin | `'cygwin'` |
| Mac OS X | `'darwin'` |
| OS/2 | `'os2'` |
| OS/2 EMX | `'os2emx'` |
| RiscOS | `'riscos'` |
| AtheOS | `'atheos'` |

#### `[sys.prefix]sys.prefix`

Строка, содержащая префикс каталога, специфичного для сайта, в который устанавливаются платформонезависимые файлы Python; по умолчанию это строка

`'/usr/local'`

. Этот префикс можно задать во время сборки с помощью аргумента

*--prefix*

скрипта

**configure**

. Основная коллекция модулей библиотек Python устанавливается в каталог

`prefix + '/lib/pythonversion'`

, в то время как платформонезависимые заголовочные файлы (все, кроме

`pyconfig.h`

) хранятся в

`prefix + '/include/pythonversion'`

, где

*version*

равно

`version[:3]`

.

#### `[sys.ps1]sys.ps1`

#### `sys.ps2`

Строки, задающие основное и дополнительное приглашения интерпретатора. Они определены только в том случае, если интерпретатор работает в интерактивном режиме. Их начальные значения в этом случае – `'>>> '` и `'... '`. Если какой-либо из этих переменных присвоить нестроковый объект, его [`str()`](https://python-all.ru/3.0/library/functions.html#str) будет вычисляться заново каждый раз, когда интерпретатор готовится прочитать новую интерактивную команду; это можно использовать для реализации динамического приглашения.

#### `[sys.dont_write_bytecode]sys.dont_write_bytecode`

Если это истинно, Python не будет пытаться создавать файлы

`.pyc`

или

`.pyo`

при импорте исходных модулей. Изначально этому параметру присваивается

`True`

или

`False`

в зависимости от опции командной строки

`-B`

и переменной окружения

`PYTHONDONTWRITEBYTECODE`

, однако его можно задать самостоятельно для управления генерацией файлов байт-кода.

#### `[sys.setcheckinterval]sys.setcheckinterval(interval)`

Устанавливает «интервал проверки» интерпретатора. Это целочисленное значение определяет, как часто интерпретатор проверяет периодические события, такие как переключения потоков и обработчики сигналов. Значение по умолчанию –

`100`

, то есть проверка выполняется каждые 100 виртуальных инструкций Python. Установка большего значения может повысить производительность для программ, использующих потоки. Установка значения

`<=`

0 приводит к проверке каждой виртуальной инструкции, максимально повышая отзывчивость, но также и накладные расходы.

#### `[sys.setdefaultencoding]sys.setdefaultencoding(name)`

Устанавливает текущую кодировку строк по умолчанию, используемую реализацией Unicode. Если

*name*

не соответствует ни одной доступной кодировке, вызывается

[`LookupError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.LookupError)

. Эта функция предназначена только для использования реализацией модуля

[`site`](https://python-all.ru/3.0/library/site.html#module-site)

и, при необходимости, модулем

`sitecustomize`

. После использования модулем

[`site`](https://python-all.ru/3.0/library/site.html#module-site)

она удаляется из пространства имён модуля

`sys`

.

#### `[sys.setdlopenflags]sys.setdlopenflags(n)`

Устанавливает флаги, используемые интерпретатором для вызовов

`dlopen`

, например, когда интерпретатор загружает модули расширений. В частности, это может включить ленивое разрешение символов при импорте модуля, если вызвать как

`sys.setdlopenflags(0)`

. Чтобы разделять символы между модулями расширений, вызывайте как

`sys.setdlopenflags(ctypes.RTLD_GLOBAL)`

. Символические имена для модулей флагов можно найти либо в модуле

[`ctypes`](https://python-all.ru/3.0/library/ctypes.html#module-ctypes)

, либо в модуле

`DLFCN`

. Если

`DLFCN`

недоступен, его можно сгенерировать из

`/usr/include/dlfcn.h`

с помощью скрипта

**h2py**

. Доступность: Unix.

#### `[sys.setfilesystemencoding]sys.setfilesystemencoding(enc)`

Устанавливает кодировку, используемую при преобразовании строк Python в имена файлов, равной

*enc*

. По умолчанию Python пытается самостоятельно определить подходящую кодировку на Unix; на Windows он полностью избегает такого преобразования. Эта функция может быть полезна, когда определение кодировки Python необходимо переопределить, например, если не все имена файлов на диске можно декодировать с использованием кодировки, выбранной Python.

#### `[sys.setprofile]sys.setprofile(profilefunc)`

Устанавливает профилирующую функцию системы, что позволяет реализовать профилировщик исходного кода Python на самом Python. См. главу [*The Python Profilers*](https://python-all.ru/3.0/library/profile.html#profile) для получения дополнительной информации о профилировщике Python. Профилирующая функция системы вызывается аналогично системной трассирующей функции (см. [`settrace()`](https://python-all.ru/3.0/library/sys.html#sys.settrace)), но не вызывается для каждой выполняемой строки кода (только при вызове и возврате, при этом событие возврата сообщается даже в случае возникновения исключения). Функция привязана к потоку, но у профилировщика нет способа узнать о переключении контекста между потоками, поэтому использование этой функции в присутствии нескольких потоков не имеет смысла. Кроме того, её возвращаемое значение не используется, поэтому она может просто возвращать `None`.

#### `[sys.setrecursionlimit]sys.setrecursionlimit(limit)`

Устанавливает максимальную глубину стека интерпретатора Python в *limit*. Этот предел предотвращает переполнение C-стека из-за бесконечной рекурсии и аварийное завершение Python.

Максимально возможное значение предела зависит от платформы. Может потребоваться установить более высокий предел для программы, требующей глубокой рекурсии, если платформа это поддерживает. Делать это нужно осторожно, так как слишком высокий предел может привести к аварийному завершению.

#### `[sys.settrace]sys.settrace(tracefunc)`

Устанавливает трассирующую функцию системы, что позволяет реализовать отладчик исходного кода Python на самом Python. Функция привязана к потоку; чтобы отладчик поддерживал несколько потоков, её необходимо зарегистрировать с помощью [`settrace()`](https://python-all.ru/3.0/library/sys.html#sys.settrace) для каждого отлаживаемого потока.

Трассирующие функции должны принимать три аргумента: *frame*, *event* и *arg*. *frame* – это текущий стековый фрейм. *event* – строка: `'call'`, `'line'`, `'return'`, `'исключение'`, `'c_call'`, `'c_return'` или `'c_exception'`. Значение *arg* зависит от типа события.

Трассирующая функция вызывается (с *event*, установленным в `'call'`) всякий раз, когда входит в новую локальную область видимости; она должна возвращать ссылку на локальную трассирующую функцию для этой области или `None`, если область не нужно трассировать.

Локальная трассирующая функция должна возвращать ссылку на саму себя (или на другую функцию для продолжения трассировки в этой области) или `None`, чтобы отключить трассировку в этой области.

События имеют следующее значение:

**`'call'`**

Вызывается функция (или вход в другой блок кода). Вызывается глобальная трассирующая функция;

*arg*

равен

`None`

; возвращаемое значение указывает локальную трассирующую функцию.

**`'line'`**

Интерпретатор собирается выполнить новую строку кода (иногда на одной строке происходит несколько событий line). Вызывается локальная функция трассировки;

*arg*

равно

`None`

; возвращаемое значение задаёт новую локальную функцию трассировки.

**`'return'`**

Функция (или другой блок кода) собирается вернуть управление. Вызывается локальная трассировочная функция;

*arg*

– значение, которое будет возвращено. Возвращаемое значение трассировочной функции игнорируется.

**`'исключение'`**

Произошло исключение. Вызывается локальная трассирующая функция;

*arg*

– это кортеж

`(исключение, value, traceback)`

; возвращаемое значение указывает новую локальную трассирующую функцию.

**`'c_call'`**

Вызов C-функции. Это может быть функция расширения или встроенная функция.

*arg*

– объект C-функции.

**`'c_return'`**

C-функция вернула управление.

*arg*

равен

`None`

.

**`'c_exception'`**

C-функция вызвала исключение.

*arg*

равен

`None`

.

Обратите внимание, что при распространении исключения вниз по цепочке вызывающих объектов событие `'исключение'` генерируется на каждом уровне.

Дополнительную информацию об объектах кода и фреймах см. в [*Стандартной иерархии типов*](https://python-all.ru/3.0/reference/datamodel.html#types).

> **Примечание**
>
> Функция [`settrace()`](https://python-all.ru/3.0/library/sys.html#sys.settrace) предназначена только для реализации отладчиков, профайлеров, инструментов анализа покрытия кода и тому подобного. Её поведение является частью платформы реализации, а не определения языка, и поэтому может быть недоступно во всех реализациях Python.

#### `[sys.settscdump]sys.settscdump(on_flag)`

Включает дамп измерений виртуальной машины с использованием счётчика тактов Pentium, если

*on\_flag*

истинно. Отключает эти дампы, если

*on\_flag*

ложно. Функция доступна, только если Python был скомпилирован с опцией

*--with-tsc*

. Чтобы понять вывод этого дампа, прочитайте

`Python/ceval.c`

в исходном коде Python.

#### `[sys.stdin]sys.stdin`

#### `sys.stdout`

#### `sys.stderr`

Объекты файлов, соответствующие стандартным потокам ввода, вывода и ошибок интерпретатора. `stdin` используется для всего ввода интерпретатора, кроме скриптов, но включая вызовы [`input()`](https://python-all.ru/3.0/library/functions.html#input). `stdout` используется для вывода [`print()`](https://python-all.ru/3.0/library/functions.html#print) и операторов [*expression*](https://python-all.ru/3.0/glossary.html#term-expression), а также для приглашений [`input()`](https://python-all.ru/3.0/library/functions.html#input). Собственные приглашения интерпретатора и (почти все) его сообщения об ошибках направляются в `stderr`. `stdout` и `stderr` не обязательно должны быть встроенными файловыми объектами: подходит любой объект с методом `write()`, принимающим строковый аргумент. (Изменение этих объектов не влияет на стандартные потоки ввода/вывода процессов, выполняемых с помощью `os.popen()`, [`os.system()`](https://python-all.ru/3.0/library/os.html#os.system) или функций семейства `exec*()` из модуля [`os`](https://python-all.ru/3.0/library/os.html#module-os).)

> **Примечание**
>
> Стандартные потоки по умолчанию находятся в текстовом режиме. Для записи или чтения двоичных данных используйте лежащий в основе двоичный буфер. Например, чтобы записать байты в [`stdout`](https://python-all.ru/3.0/library/sys.html#sys.stdout), используйте `sys.stdout.buffer.write(b'abc')`.

#### `[sys.__stdin__]sys.__stdin__`

#### `sys.__stdout__`

#### `sys.__stderr__`

> Эти объекты содержат исходные значения
>
> `stdin`
>
> ,
>
> `stderr`
>
> и
>
> `stdout`
>
> на момент запуска программы. Они используются во время финализации и могут быть полезны для восстановления реальных файлов до известных работоспособных файловых объектов, если они были перезаписаны сломанным объектом.

> **Примечание**
>
> При некоторых условиях `stdin`, `stdout` и `stderr`, а также исходные значения `__stdin__`, `__stdout__` и `__stderr__` могут быть равны None. Обычно это характерно для GUI-приложений Windows, не подключенных к консоли, и для Python-приложений, запущенных с помощью **pythonw**.

#### `[sys.tracebacklimit]sys.tracebacklimit`

Когда этой переменной присвоено целое значение, она определяет максимальное количество уровней трассировки, выводимых при необработанном исключении. По умолчанию

`1000`

. Если установлено

`0`

или меньше, вся информация трассировки подавляется и выводятся только тип и значение исключения.

#### `[sys.version]sys.version`

Строка, содержащая номер версии интерпретатора Python, а также дополнительную информацию о номере сборки и используемом компиляторе. Она имеет значение вида `'version (#build_number, build_date, build_time) [compiler]'`. Первые три символа используются для идентификации версии в каталогах установки (где это применимо на каждой платформе). Пример:

```python
>>> import sys
>>> sys.version
'1.5.2 (#0 Apr 13 1999, 10:51:12) [MSC 32 bit (Intel)]'
```

#### `[sys.api_version]sys.api_version`

Версия C API для данного интерпретатора. Программисты могут счесть это полезным при отладке конфликтов версий между Python и модулями расширения.

#### `[sys.version_info]sys.version_info`

Кортеж, содержащий пять компонентов номера версии:

*major*

,

*minor*

,

*micro*

,

*releaselevel*

и

*serial*

. Все значения, кроме

*releaselevel*

, являются целыми числами; release level – это

`'alpha'`

,

`'beta'`

,

`'candidate'`

или

`'final'`

. Значение

`version_info`

, соответствующее версии Python 2.0, равно

`(2, 0, 0, 'final', 0)`

.

#### `[sys.warnoptions]sys.warnoptions`

Это деталь реализации инфраструктуры предупреждений; не изменяйте это значение. Обратитесь к модулю

[`warnings`](https://python-all.ru/3.0/library/warnings.html#module-warnings)

для получения дополнительной информации об инфраструктуре предупреждений.

#### `[sys.winver]sys.winver`

Номер версии, используемый для формирования ключей реестра на платформах Windows. Он хранится как строковый ресурс 1000 в DLL Python. Обычно значение – это первые три символа

[`version`](https://python-all.ru/3.0/library/sys.html#sys.version)

. Он предоставляется в модуле

`sys`

в информационных целях; изменение этого значения не влияет на ключи реестра, используемые Python. Доступность: Windows.