msvcrt
MS Windows 特定服务
这些函数提供对 Windows 平台某些有用能力的访问。某些更高级模块使用这些函数来构建其服务的 Windows 实现。例如, getpass 模块使用这以实现 getpass() 函数。
getpass
getpass()
可以在平台 API 文档编制中找到有关这些函数的进一步文档编制。
模块实现控制台 I/O API 正常和宽字符变体两者。正常 API 仅处理 ASCII 字符,且对于国际化应用程序的用途有限。应尽可能使用宽字符 API。
3.3 版改变: 此模块中的操作现在引发 OSError where IOError 被引发。
OSError
IOError
锁定文件部分基于文件描述符 fd 从 C 运行时。引发 OSError 当失败时。文件的锁定区域从当前文件位置扩展 nbytes 字节,且在 EOF (文件末尾) 后可能继续。 mode 必须是某一 LK_* 常量下文有列出。可以同时锁定文件中的多个区域,但不可重叠。相邻区域不合并;必须单独解锁它们。
LK_*
引发 审计事件 msvcrt.locking 采用自变量 fd , mode , nbytes .
msvcrt.locking
fd
mode
nbytes
锁定指定字节。若无法锁定字节,程序在 1 秒后立即再试。若 10 次尝试后无法锁定字节, OSError 被引发。
锁定指定字节。若无法锁定字节, OSError 被引发。
解锁指定字节 (先前必须被锁定)。
设置行尾翻译模式为文件描述符 fd 。要把它设为文本模式, flags 应该为 os.O_TEXT ;对于二进制,它应该是 os.O_BINARY .
os.O_TEXT
os.O_BINARY
创建 C 运行时文件描述符从文件句柄 handle 。 flags 参数应该是按位 OR 的 os.O_APPEND , os.O_RDONLY ,和 os.O_TEXT 。可以用作参数的文件描述符返回给 os.fdopen() 以创建文件对象。
os.O_APPEND
os.O_RDONLY
os.fdopen()
引发 审计事件 msvcrt.open_osfhandle 采用自变量 handle , flags .
msvcrt.open_osfhandle
handle
flags
返回文件句柄对于文件描述符 fd 。引发 OSError if fd 无法识别。
引发 审计事件 msvcrt.get_osfhandle 采用自变量 fd .
msvcrt.get_osfhandle
返回 True 若按键正等待被读取。
True
读取按键并将结果字符作为字节字符串返回。什么都不回显到控制台。此调用将阻塞,若按键已不可用,但不会等待 Enter 被按下。若按下的键是特殊功能键,这会返回 '\000' or '\xe0' ; the next call will return the keycode. The Control - C 按键无法被读取采用此函数。
'\000'
'\xe0'
宽字符变体的 getch() ,返回 Unicode 值。
getch()
类似于 getch() ,但将回显按键,若它表示可打印字符。
宽字符变体的 getche() ,返回 Unicode 值。
getche()
打印字节字符串 char 到控制台而不缓冲。
宽字符变体的 putch() ,接受 Unicode 值。
putch()
导致字节字符串 char 被压回控制台缓冲;它将是下一个字符当读取通过 getch() or getche() .
宽字符变体的 ungetch() ,接受 Unicode 值。
ungetch()
强制 malloc() 堆清理自身并将未使用块返回给操作系统。当故障时,这引发 OSError .
malloc()
The CRT Assembly version, from the crtassem.h 头文件。
crtassem.h
The VC Assembly public key token, from the crtassem.h 头文件。
The Libraries Assembly name prefix, from the crtassem.h 头文件。
winreg — Windows 注册表访问
winreg
键入搜索术语或模块、类、函数名称。