### 導航 - [索引](../genindex.xhtml "總目錄") - [模塊](../py-modindex.xhtml "Python 模塊索引") | - [下一頁](winreg.xhtml "winreg --- Windows 注冊表訪問") | - [上一頁](msilib.xhtml "msilib --- Read and write Microsoft Installer files") | -  - [Python](https://www.python.org/) ? - zh\_CN 3.7.3 [文檔](../index.xhtml) ? - [Python 標準庫](index.xhtml) ? - [Windows系統相關模塊](windows.xhtml) ? - $('.inline-search').show(0); | # [`msvcrt`](#module-msvcrt "msvcrt: Miscellaneous useful routines from the MS VC++ runtime. (Windows)") --- 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`](getpass.xhtml#module-getpass "getpass: Portable reading of passwords and retrieval of the userid.") module uses this in the implementation of the [`getpass()`](getpass.xhtml#module-getpass "getpass: Portable reading of passwords and retrieval of the userid.") function. Further documentation on these functions can be found in the Platform API documentation. The module implements both the normal and wide char variants of the console I/O api. The normal API deals only with ASCII characters and is of limited use for internationalized applications. The wide char API should be used where ever possible. 在 3.3 版更改: Operations in this module now raise [`OSError`](exceptions.xhtml#OSError "OSError") where [`IOError`](exceptions.xhtml#IOError "IOError")was raised. ## File Operations `msvcrt.``locking`(*fd*, *mode*, *nbytes*)Lock part of a file based on file descriptor *fd* from the C runtime. Raises [`OSError`](exceptions.xhtml#OSError "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 the `LK_*` 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.``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`](exceptions.xhtml#OSError "OSError") is raised. `msvcrt.``LK_NBLCK``msvcrt.``LK_NBRLCK`Locks the specified bytes. If the bytes cannot be locked, [`OSError`](exceptions.xhtml#OSError "OSError") is raised. `msvcrt.``LK_UNLCK`Unlocks the specified bytes, which must have been previously locked. `msvcrt.``setmode`(*fd*, *flags*)Set the line-end translation mode for the file descriptor *fd*. To set it to text mode, *flags* should be [`os.O_TEXT`](os.xhtml#os.O_TEXT "os.O_TEXT"); for binary, it should be [`os.O_BINARY`](os.xhtml#os.O_BINARY "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.xhtml#os.O_APPEND "os.O_APPEND"), [`os.O_RDONLY`](os.xhtml#os.O_RDONLY "os.O_RDONLY"), and [`os.O_TEXT`](os.xhtml#os.O_TEXT "os.O_TEXT"). The returned file descriptor may be used as a parameter to [`os.fdopen()`](os.xhtml#os.fdopen "os.fdopen") to create a file object. `msvcrt.``get_osfhandle`(*fd*)Return the file handle for the file descriptor *fd*. Raises [`OSError`](exceptions.xhtml#OSError "OSError") if *fd* is not recognized. ## Console I/O `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.``getwch`()Wide char variant of [`getch()`](#msvcrt.getch "msvcrt.getch"), returning a Unicode value. `msvcrt.``getche`()Similar to [`getch()`](#msvcrt.getch "msvcrt.getch"), but the keypress will be echoed if it represents a printable character. `msvcrt.``getwche`()Wide char variant of [`getche()`](#msvcrt.getche "msvcrt.getche"), returning a Unicode value. `msvcrt.``putch`(*char*)Print the byte string *char* to the console without buffering. `msvcrt.``putwch`(*unicode\_char*)Wide char variant of [`putch()`](#msvcrt.putch "msvcrt.putch"), accepting a Unicode value. `msvcrt.``ungetch`(*char*)Cause the byte string *char* to be "pushed back" into the console buffer; it will be the next character read by [`getch()`](#msvcrt.getch "msvcrt.getch") or [`getche()`](#msvcrt.getche "msvcrt.getche"). `msvcrt.``ungetwch`(*unicode\_char*)Wide char variant of [`ungetch()`](#msvcrt.ungetch "msvcrt.ungetch"), accepting a Unicode value. ## Other Functions `msvcrt.``heapmin`()Force the `malloc()` heap to clean itself up and return unused blocks to the operating system. On failure, this raises [`OSError`](exceptions.xhtml#OSError "OSError"). ### 導航 - [索引](../genindex.xhtml "總目錄") - [模塊](../py-modindex.xhtml "Python 模塊索引") | - [下一頁](winreg.xhtml "winreg --- Windows 注冊表訪問") | - [上一頁](msilib.xhtml "msilib --- Read and write Microsoft Installer files") | -  - [Python](https://www.python.org/) ? - zh\_CN 3.7.3 [文檔](../index.xhtml) ? - [Python 標準庫](index.xhtml) ? - [Windows系統相關模塊](windows.xhtml) ? - $('.inline-search').show(0); | ? [版權所有](../copyright.xhtml) 2001-2019, Python Software Foundation. Python 軟件基金會是一個非盈利組織。 [請捐助。](https://www.python.org/psf/donations/) 最后更新于 5月 21, 2019. [發現了問題](../bugs.xhtml)？ 使用[Sphinx](http://sphinx.pocoo.org/)1.8.4 創建。