> **Источник:** https://python-all.ru/3.8/library/msvcrt.html > > «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor. --- # [`msvcrt`](https://python-all.ru/3.8/library/msvcrt.html#module-msvcrt) – полезные утилиты из MS VC++ runtime --- Эти функции предоставляют доступ к некоторым полезным возможностям на платформах Windows. Некоторые модули более высокого уровня используют эти функции для создания реализаций своих служб в Windows. Например, модуль [`getpass`](https://python-all.ru/3.8/library/getpass.html#module-getpass) использует его в реализации функции [`getpass()`](https://python-all.ru/3.8/library/getpass.html#module-getpass). Дополнительную документацию по этим функциям можно найти в документации Platform API. Модуль реализует как обычную, так и широкосимвольную версию консольного API ввода-вывода. Обычный API работает только с ASCII-символами и имеет ограниченное применение для интернационализированных приложений. Широкосимвольный API следует использовать везде, где это возможно. Изменено в версии 3.3: Операции в этом модуле теперь вызывают [`OSError`](https://python-all.ru/3.8/library/exceptions.html#OSError) вместо [`IOError`](https://python-all.ru/3.8/library/exceptions.html#IOError). ## Файловые операции #### `msvcrt.locking(fd, mode, nbytes)` Блокирует часть файла на основе файлового дескриптора *fd* из среды выполнения C. В случае ошибки вызывает исключение [`OSError`](https://python-all.ru/3.8/library/exceptions.html#OSError). Заблокированная область файла начинается от текущей позиции в файле и занимает *nbytes* байт; она может выходить за конец файла. *mode* должен быть одной из констант `LK_*`, перечисленных ниже. В файле можно одновременно блокировать несколько областей, но они не должны перекрываться. Смежные области не объединяются; их необходимо разблокировать по отдельности. Вызывает [событие аудита](https://python-all.ru/3.8/library/sys.html#auditing) `msvcrt.locking` с аргументами `fd`, `mode`, `nbytes`. #### `msvcrt.LK_LOCK` #### `msvcrt.LK_RLCK` Блокирует указанные байты. Если байты не удаётся заблокировать, программа повторяет попытку через 1 секунду. Если после 10 попыток заблокировать байты не удаётся, вызывается исключение [`OSError`](https://python-all.ru/3.8/library/exceptions.html#OSError). #### `msvcrt.LK_NBLCK` #### `msvcrt.LK_NBRLCK` Блокирует указанные байты. Если байты не удаётся заблокировать, возбуждается [`OSError`](https://python-all.ru/3.8/library/exceptions.html#OSError). #### `msvcrt.LK_UNLCK` Разблокирует указанные байты, которые должны быть предварительно заблокированы. #### `msvcrt.setmode(fd, flags)` Устанавливает режим преобразования концов строк для файлового дескриптора *fd*. Чтобы установить текстовый режим, *flags* должен быть [`os.O_TEXT`](https://python-all.ru/3.8/library/os.html#os.O_TEXT); для двоичного – [`os.O_BINARY`](https://python-all.ru/3.8/library/os.html#os.O_BINARY). #### `msvcrt.open_osfhandle(handle, flags)` Создаёт файловый дескриптор среды выполнения C из дескриптора файла (handle) *handle*. Параметр *flags* должен быть побитовым ИЛИ значений [`os.O_APPEND`](https://python-all.ru/3.8/library/os.html#os.O_APPEND), [`os.O_RDONLY`](https://python-all.ru/3.8/library/os.html#os.O_RDONLY) и [`os.O_TEXT`](https://python-all.ru/3.8/library/os.html#os.O_TEXT). Возвращаемый файловый дескриптор можно использовать в качестве параметра для [`os.fdopen()`](https://python-all.ru/3.8/library/os.html#os.fdopen), чтобы создать файловый объект. Возбуждает [событие аудита](https://python-all.ru/3.8/library/sys.html#auditing) `msvcrt.open_osfhandle` с аргументами `handle`, `flags`. #### `msvcrt.get_osfhandle(fd)` Возвращает дескриптор файла (handle) для файлового дескриптора *fd*. Вызывает исключение [`OSError`](https://python-all.ru/3.8/library/exceptions.html#OSError), если *fd* не распознан. Вызывает [событие аудита](https://python-all.ru/3.8/library/sys.html#auditing) `msvcrt.get_osfhandle` с аргументом `fd`. ## Консольный ввод-вывод #### `msvcrt.kbhit()` Возвращает `True`, если есть ожидающее нажатие клавиши. #### `msvcrt.getch()` Читает нажатие клавиши и возвращает результирующий символ в виде байтовой строки. Ничего не выводится на консоль. Этот вызов блокируется, если нажатие клавиши ещё не доступно, но не будет ждать нажатия `Enter`. Если нажатая клавиша была специальной функциональной клавишей, то будет возвращено `'\000'` или `'\xe0'`; следующий вызов вернет код клавиши. Нажатие `Control-C` не может быть прочитано этой функцией. #### `msvcrt.getwch()` Расширенный (wide char) вариант [`getch()`](https://python-all.ru/3.8/library/msvcrt.html#msvcrt.getch), возвращающий значение Unicode. #### `msvcrt.getche()` Аналогично [`getch()`](https://python-all.ru/3.8/library/msvcrt.html#msvcrt.getch), но нажатие клавиши будет выведено на экран, если оно представляет печатный символ. #### `msvcrt.getwche()` Расширенный (wide char) вариант [`getche()`](https://python-all.ru/3.8/library/msvcrt.html#msvcrt.getche), возвращающий значение Unicode. #### `msvcrt.putch(char)` Выводит байтовую строку *char* на консоль без буферизации. #### `msvcrt.putwch(unicode_char)` Расширенный (wide char) вариант [`putch()`](https://python-all.ru/3.8/library/msvcrt.html#msvcrt.putch), принимающий значение Unicode. #### `msvcrt.ungetch(char)` Помещает байтовую строку *char* обратно в буфер консоли; она будет прочитана как следующий символ с помощью [`getch()`](https://python-all.ru/3.8/library/msvcrt.html#msvcrt.getch) или [`getche()`](https://python-all.ru/3.8/library/msvcrt.html#msvcrt.getche). #### `msvcrt.ungetwch(unicode_char)` Расширенный (wide char) вариант [`ungetch()`](https://python-all.ru/3.8/library/msvcrt.html#msvcrt.ungetch), принимающий значение Unicode. ## Другие функции #### `msvcrt.heapmin()` Принуждает кучу `malloc()` очиститься и вернуть неиспользуемые блоки операционной системе. В случае ошибки вызывает [`OSError`](https://python-all.ru/3.8/library/exceptions.html#OSError).