microsoft / microsoft/vscode-cpptools
Printing unicode to debug console via stdout is only possible in current console input code page
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 6.2k
- Forks
- 1.7k
- Avg merge
- 14h 46m
- Merged PRs (30d)
- 61
Description
Environment
- OS and version: Any Windows
- VS Code: 1.75.1 tested, presumably any
- C/C++ extension: 1.14.3 tested, presumably any
Bug Summary and Steps to Reproduce
When using "Start Debugging" or "Run Without Debugging" and the launch.json configuration "console": "internalConsole", the Debug Console displays stdout (and with "Start Debugging", strings passed to OutputDebugString - OutputDebugStringW is unaffected by this issue: If a debugger is present (which can be checked via IsDebuggerPresent()), unicode passed as UTF-16 will be printed correctly).
For the Debug Console, stdout is however always expected to convey bytes encoded in the active console input page, as retrieved with GetConsoleCP.
When running a program using "Run Without Debugging" and "console": "internalConsole" and printing strings to stdout, this is especially cumbersome: It is essentially impossible to print unicode characters that are not part of the code page that is returned by GetConsoleCP() without modifying the console input code page. But also with the proper debugger (e. g. "Start Debugging"), strings printed to stdout (not WriteConsole or OutputDebugString) are expected to be encoded in the active console input code page, which most probably does not support all unicode characters.
This snippet demonstrates the steps necessary to get the unicode character ° via stdout printed properly to the Debug Console:
#include <Windows.h>
int main() {
const UINT console_cp = GetConsoleCP();
char str[3];
WideCharToMultiByte(console_cp, 0, L"°\n", 2, str, 3, NULL, NULL);
str[2] = 0;
WriteFile(GetStdHandle(STD_OUTPUT_HANDLE), str, 2, NULL, NULL);
// If GetConsoleCP == 850, identical to:
WriteFile(GetStdHandle(STD_OUTPUT_HANDLE), "\xF8\x0A", 2, NULL, NULL);
}
... which proves my assumption about the expected encoding of stdout.
A workaround is to call SetConsoleCP(65001); and printing UTF-8 to stdout, but this has undesired side effects. Also, it is impossible to detect that the process is being redirected to "VS Code Debug Console", so the call would always have to be present, which I would also rather avoid, if possible.
In my opinion, it would be great if it was possible to tell the "piping process" (whichever that is, e. g. closed source VS C++ debugger?) what encoding of stdout to expect.
Note that switching the client-side calls (WriteFile, printf, or wprintf) has no effect: It depends entirely on what bytes are written to stdout.
Debugger Configurations
{
"version": "0.2.0",
"configurations": [
{
"name": "Debug main.exe",
"type": "cppvsdbg",
"request": "launch",
"program": "main.exe",
"args": [],
"stopAtEntry": false,
"cwd": "${fileDirname}",
"environment": [],
"console": "internalConsole",
"internalConsoleOptions": "openOnSessionStart"
}
]
}
Debugger Logs
Not applicable
Other Extensions
No response
Additional Information
Expected output in the Debug Console (reproducable in code page 850 with 0xF8 0x0A):
You may only use the C/C++ Extension for Visual Studio Code
with Visual Studio Code, Visual Studio or Visual Studio for Mac
software to help you develop and test your applications.
-------------------------------------------------------------------
°
With puts("°"); (e. g. 0xc2 0xb0):
You may only use the C/C++ Extension for Visual Studio Code
with Visual Studio Code, Visual Studio or Visual Studio for Mac
software to help you develop and test your applications.
-------------------------------------------------------------------
┬░
The biggest issue is essentially that when running using "Start Without Debugging", neither WriteConsole nor OutputDebugString work, thus, putting unicode outside of the current console input code page into the Debug Console is impossible without the SetConsoleCP hack.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the launch.json configuration using "console": "internalConsole" and run the provided Windows C++ reproduction, comparing stdout encoded for the active console code page with UTF-8 output. Trace how the VS Code Debug Console receives stdout during Start Debugging and Run Without Debugging; done means Unicode stdout displays correctly without requiring SetConsoleCP(65001).
Written by the indexing model from the issue text.
Assessment
- Tech stack
- cpp, typescript, vscode
- Domain
- devtools, tooling
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100