msvcrt
— Useful routines from the MS VC++ runtime¶
These functions provide access to some useful capabilities on Windows platforms.
Some higher-level modules use these functions to build the Windows
implementations of their services. For example, the getpass
module uses
this in the implementation of the getpass()
function.
Додаткову документацію щодо цих функцій можна знайти в документації API платформи.
Модуль реалізує як звичайний, так і широкий варіанти char API консолі вводу-виводу. Звичайний API працює лише з символами ASCII і обмежено використовується для інтернаціоналізованих програм. Широкий char API слід використовувати, де це можливо.
Змінено в версії 3.3: Операції в цьому модулі тепер викликають OSError
там, де було викликано IOError
.
Операції з файлами¶
-
msvcrt.
locking
(fd, mode, nbytes)¶ Lock part of a file based on file descriptor fd from the C runtime. Raises
OSError
on failure. The locked region of the file extends from the current file position for nbytes bytes, and may continue beyond the end of the file. mode must be one of theLK_*
constants listed below. Multiple regions in a file may be locked at the same time, but may not overlap. Adjacent regions are not merged; they must be unlocked individually.Викликає подію аудиту
msvcrt.locking
з аргументамиfd
,mode
,nbytes
.
-
msvcrt.
LK_LOCK
¶ -
msvcrt.
LK_RLCK
¶ Locks the specified bytes. If the bytes cannot be locked, the program immediately tries again after 1 second. If, after 10 attempts, the bytes cannot be locked,
OSError
is raised.
-
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)¶ Create a C runtime file descriptor from the file handle handle. The flags parameter should be a bitwise OR of
os.O_APPEND
,os.O_RDONLY
, andos.O_TEXT
. The returned file descriptor may be used as a parameter toos.fdopen()
to create a file object.Викликає подію аудиту
msvcrt.open_osfhandle
з аргументамиhandle
,flags
.
-
msvcrt.
get_osfhandle
(fd)¶ Return the file handle for the file descriptor fd. Raises
OSError
if fd is not recognized.Викликає подію аудиту
msvcrt.get_osfhandle
з аргументомfd
.
Консоль введення/виведення¶
-
msvcrt.
kbhit
()¶ Return
True
if a keypress is waiting to be read.
-
msvcrt.
getch
()¶ Read a keypress and return the resulting character as a byte string. Nothing is echoed to the console. This call will block if a keypress is not already available, but will not wait for Enter to be pressed. If the pressed key was a special function key, this will return
'\000'
or'\xe0'
; the next call will return the keycode. The Control-C keypress cannot be read with this function.
-
msvcrt.
getche
()¶ Similar to
getch()
, but the keypress will be echoed if it represents a printable character.
-
msvcrt.
putch
(char)¶ Вивести рядок байтів char на консоль без буферизації.