msvcrt SetErrorMode not documented

[giampaolo]

BPO	30295
Nosy	@pfmoore, @giampaolo, @tjguk, @zware, @eryksun, @zooba

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = None
created_at = <Date 2017-05-07.12:24:20.777>
labels = ['3.8', '3.9', '3.10', 'type-feature', 'library', 'OS-windows', 'docs']
title = 'msvcrt SetErrorMode not documented'
updated_at = <Date 2021-03-06.15:34:24.241>
user = 'https://github.com/giampaolo'

bugs.python.org fields:

activity = <Date 2021-03-06.15:34:24.241>
actor = 'eryksun'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation', 'Library (Lib)', 'Windows']
creation = <Date 2017-05-07.12:24:20.777>
creator = 'giampaolo.rodola'
dependencies = []
files = []
hgrepos = []
issue_num = 30295
keywords = []
message_count = 2.0
messages = ['293189', '293200']
nosy_count = 7.0
nosy_names = ['paul.moore', 'giampaolo.rodola', 'tim.golden', 'docs@python', 'zach.ware', 'eryksun', 'steve.dower']
pr_nums = []
priority = 'normal'
resolution = None
stage = None
status = 'open'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue30295'
versions = ['Python 3.8', 'Python 3.9', 'Python 3.10']

Linked PRs

• gh-74481: add missing docs and costs in msvcrt #109650

[giampaolo]

Also SEM_FAILCRITICALERRORS and other SEM_constants. They should as setting error mode on Windows for console applications is a pretty common use case (in fact ./Lib/test/libregrtest/setup.py uses it).

[eryksun]

msvcrt set_error_mode, CrtReportMode, CrtReportFile and the associated CRT constants should be documented for use with debug builds. Also, msvcrt is missing the set_error_mode constants _OUT_TO_DEFAULT, _OUT_TO_STDERR, _OUT_TO_MSGBOX, and _REPORT_ERRMODE.

SetErrorMode 1 and the SEM_* constants are defined in msvcrt, for convenience I suppose. They're not related to the CRT. I think they should be aliased in the os module and documented there. GetErrorMode 2 can also be provided in Python 3.5+. It would be useful to also provide SetThreadErrorMode 3 and GetThreadErrorMode conditionally in Windows 7+, which is practically all Windows users nowadays.