msvcrt – полезные утилиты из MS VC++ runtime¶msvcrt – Useful routines from the MS VC++ runtime

Файловые операции¶File Operations

msvcrt.locking(fd, mode, nbytes)¶

Блокирует часть файла на основе файлового дескриптора fd из среды выполнения C. В случае ошибки вызывает исключение OSError. Заблокированная область файла начинается от текущей позиции в файле и занимает nbytes байт; она может выходить за конец файла. mode должен быть одной из констант LK_*, перечисленных ниже. В файле можно одновременно блокировать несколько областей, но они не должны перекрываться. Смежные области не объединяются; их необходимо разблокировать по отдельности.

Вызывает событие аудита msvcrt.locking с аргументами fd, mode, nbytes.

msvcrt.LK_LOCK¶

msvcrt.LK_RLCK¶

Блокирует указанные байты. Если байты не удаётся заблокировать, программа повторяет попытку через 1 секунду. Если после 10 попыток заблокировать байты не удаётся, вызывается исключение OSError.

msvcrt.LK_NBLCK¶

msvcrt.LK_NBRLCK¶

Блокирует указанные байты. Если байты не удаётся заблокировать, возбуждается OSError.

msvcrt.LK_UNLCK¶

Разблокирует указанные байты, которые должны быть предварительно заблокированы.

msvcrt.setmode(fd, flags)¶

Устанавливает режим преобразования концов строк для файлового дескриптора fd. Чтобы установить текстовый режим, flags должен быть os.O_TEXT; для двоичного – os.O_BINARY.

msvcrt.open_osfhandle(handle, flags)¶

Создаёт файловый дескриптор среды выполнения C из дескриптора файла (handle) handle. Параметр flags должен быть побитовым ИЛИ значений os.O_APPEND, os.O_RDONLY и os.O_TEXT. Возвращаемый файловый дескриптор можно использовать в качестве параметра для os.fdopen(), чтобы создать файловый объект.

Возбуждает событие аудита msvcrt.open_osfhandle с аргументами handle, flags.

msvcrt.get_osfhandle(fd)¶

Возвращает дескриптор файла (handle) для файлового дескриптора fd. Вызывает исключение OSError, если fd не распознан.

Вызывает событие аудита msvcrt.get_osfhandle с аргументом fd.

Консольный ввод-вывод¶Console I/O

msvcrt.kbhit()¶

Возвращает True, если есть ожидающее нажатие клавиши.

msvcrt.getch()¶

Читает нажатие клавиши и возвращает результирующий символ в виде байтовой строки. Ничего не выводится на консоль. Этот вызов блокируется, если нажатие клавиши ещё не доступно, но не будет ждать нажатия Enter. Если нажатая клавиша была специальной функциональной клавишей, то будет возвращено '\000' или '\xe0'; следующий вызов вернет код клавиши. Нажатие Control-C не может быть прочитано этой функцией.

msvcrt.getwch()¶

Расширенный (wide char) вариант getch(), возвращающий значение Unicode.

msvcrt.getche()¶

Аналогично getch(), но нажатие клавиши будет выведено на экран, если оно представляет печатный символ.

msvcrt.getwche()¶

Расширенный (wide char) вариант getche(), возвращающий значение Unicode.

msvcrt.putch(char)¶

Выводит байтовую строку char на консоль без буферизации.

msvcrt.putwch(unicode_char)¶

Расширенный (wide char) вариант putch(), принимающий значение Unicode.

msvcrt.ungetch(char)¶

Помещает байтовую строку char обратно в буфер консоли; она будет прочитана как следующий символ с помощью getch() или getche().

msvcrt.ungetwch(unicode_char)¶

Расширенный (wide char) вариант ungetch(), принимающий значение Unicode.

Другие функции¶Other Functions

msvcrt.heapmin()¶

Принудительно очищает кучу malloc() и возвращает неиспользуемые блоки операционной системе. В случае ошибки вызывает исключение OSError.

msvcrt.CRT_ASSEMBLY_VERSION¶

Версия сборки CRT из файла заголовка crtassem.h.

msvcrt.VC_ASSEMBLY_PUBLICKEYTOKEN¶

Токен открытого ключа сборки VC из файла заголовка crtassem.h.

msvcrt.LIBRARIES_ASSEMBLY_NAME_PREFIX¶

Префикс имени сборки Libraries из файла заголовка crtassem.h.