msvcrt --- 来自 MS VC++ 运行时的有用例程¶
源代码: PC/msvcrtmodule.c
这些函数提供了对 Windows 平台上一些有用功能的访问。 一些更高层级的模块使用这些函数来构建其服务的 Windows 实现。 例如，getpass 模块在 getpass() 函数的实现中就用到了它。
关于这些函数的更多信息可以在平台 API 文档中找到。
该模块实现了控制台 I/O API 的普通和宽字符变体。普通的 API 只处理ASCII字符，国际化应用受限。应该尽可能地使用宽字符 API 。
适用范围: Windows.
文件操作¶
- 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_UNLCK¶
解锁指定的字节数据，它们必须在之前已被锁定。
- msvcrt.setmode(fd, flags)¶
设置文件描述符 fd 的行结束符转写模式。 要将其设为文本模式，则 flags 应当为
os.O_TEXT；设为二进制模式，则应当为os.O_BINARY。
- msvcrt.open_osfhandle(handle, flags)¶
基于文件句柄 handle 创建一个 C 运行时文件描述符。 flags 形参应当是
os.O_APPEND,os.O_RDONLY,os.O_TEXT和os.O_NOINHERIT按位 OR 的结果。 返回的文件描述符可以被用作传给os.fdopen()的形参以创建一个文件对象。该文件描述符默认是可继承的。 传入
os.O_NOINHERIT标志可使其成为不可继承的。引发一个 审计事件
msvcrt.open_osfhandle并附带参数handle,flags。
控制台 I/O¶
- msvcrt.kbhit()¶
如果正在等待读取一个按键则返回一个非零值。 在其他情况下，将返回 0。
- msvcrt.getch()¶
读取一个按键并将结果字符以字节串形式返回。 不会回显到控制台。 如果没有任何按键可用则此调用将会阻塞，但它不会等待 Enter 被按下。 如果按下的键是一个特殊功能键，此函数将返回
'\000'或'\xe0'；下一次调用将返回键代码。 Control-C 按键无法使用此函数来读取。
- msvcrt.putch(char)¶
Print the byte string char to the console without buffering. Raises
OSErroron failure, for example when the process has no console attached.在 3.16.0a0 (unreleased) 版本发生变更: Failures are now reported by raising
OSErrorinstead of being silently ignored.
其他函数¶
- msvcrt.set_error_mode(mode)¶
更改 C 运行时为可能终止程序的错误写入错误消息的位置。 mode 必须是下面列出的
OUT_*常量或REPORT_ERRMODE中的一个。 返回旧设置或者在有错误发生时返回 -1。 仅在 Python 调试构建版 中可用。
- msvcrt.OUT_TO_DEFAULT¶
错误 sink 是由应用程序的类型决定的。 仅在 Python 调试构建版 中可用。
- msvcrt.OUT_TO_STDERR¶
错误 sink 是某个标准错误。 仅在 Python 调试构建版 中可用。
- msvcrt.OUT_TO_MSGBOX¶
错误 sink 是某个消息框。 仅在 Python 调试构建版 中可用。
- msvcrt.REPORT_ERRMODE¶
报告当前错误模式值。 仅在 Python 调试构建版 中可用。
- msvcrt.CrtSetReportMode(type, mode)¶
为
_CrtDbgReport()在 MS VC++ 运行时中生成的特定报告类型指定一个目标或多个目标。 type 必须是下面列出的CRT_*常量之一。 mode 必须是下面列出的CRTDBG_*常量之一。 仅在 Python 调试构建版 中可用。
- msvcrt.CrtSetReportFile(type, file)¶
在你使用
CrtSetReportMode()来指定CRTDBG_MODE_FILE之后，你可以指定接收消息文本的文件句柄。 type 必须是下面列出的CRT_*常量之一。 file 应当是你希望指定的文件句柄。 仅在 Python 调试构建版 中可用。
- msvcrt.CRT_WARN¶
不需要立即关注的警告、消息和信息。
- msvcrt.CRT_ERROR¶
需要立即关注的错误、不可恢复的问题和议题。
- msvcrt.CRT_ASSERT¶
断言失败
- msvcrt.CRTDBG_MODE_DEBUG¶
将消息写至调试器的输出窗口。
- msvcrt.CRTDBG_MODE_FILE¶
将消息写入用户提供的文件句柄。 应当调用
CrtSetReportFile()来定义要用作写入目标的特定文件或流。
- msvcrt.CRTDBG_MODE_WNDW¶
创建一个消息框来显示消息并提供
Abort,Retry和Ignore等按钮。
- msvcrt.CRTDBG_REPORT_MODE¶
返回指定 type 当前的 mode。
- msvcrt.CRT_ASSEMBLY_VERSION¶
CRT Assembly 版本，来自
crtassem.h头文件。
- msvcrt.VC_ASSEMBLY_PUBLICKEYTOKEN¶
VC Assembly 公钥令牌，来自
crtassem.h头文件。
- msvcrt.LIBRARIES_ASSEMBLY_NAME_PREFIX¶
Libraries Assembly 名称前缀，来自
crtassem.h头文件。