From: "naruse (Yui NARUSE) via ruby-core" Date: 2025-12-11T13:46:25+00:00 Subject: [ruby-core:124143] [Ruby Feature#20959] Add a way to get codepage of console. Issue #20959 has been updated by naruse (Yui NARUSE). I think your idea is that Microsoft is pushing more for UTF-8 support in console apps using the Visual C++ runtime, and in the future, setting the locale to UTF-8 might become the usual way. If that happens, the console code page and locale code page could end up not matching, so adding `Encoding.find("console")` would probably be a good idea. I totally agree with the first part���it's nice to see Ruby adapting to these updates. Also, like you said, Windows has a few main encodings that apps deal with: * ACP * Console code page * Console output code page And yes, Ruby's `Encoding.find("locale")` usually uses `GetConsoleCP()`, because the input encoding follows the console code page. But if Ruby starts using `setlocale(LC_CTYPE, ".utf8")`, it would handle outside stuff with UTF-8 or the Wide APIs. In that case, do we really need the console code page as much? For example, right now, Ruby can already output Unicode strings to the console using `WriteConsoleW`, without worrying about the console output code page. > The code page we can get from Windows also has ACP and OEMCP, but are these necessary? Encoding.find("filesystem") returns OEMCP because filesystem (VFAT/FAT32) uses OEMCP. > Is it reasonable to get locale_encoding if Encoding.find("console") is called on other platforms? If `Encoding.find("console")` is the encoding of the input from console, it will be the encoding of the terminal on Unix. Usually it is inherited to the application, but as far as I know, there is no way to get it from the application. ---------------------------------------- Feature #20959: Add a way to get codepage of console. https://bugs.ruby-lang.org/issues/20959#change-115598 * Author: YO4 (Yoshinao Muramatsu) * Status: Assigned * Assignee: windows ---------------------------------------- # Abstract Add a way to retrieve code pages of console. On Windows, Encoding.find("locale") returns the console codepage. To prepare for future changes, specify ```console``` instead of ```locale``` to get the encoding when a console code page is needed. # Background On Windows, Encoding.find("locale") returns the console codepage. This is different from locale in other environments. Also the name and content do not seem to match. In the future, if we change the locale_encoding of the Windows port to the locale codepage of the C runtime library, we need to get the encoding for the console. Strings received via pipe from cmd.exe or powershell are encoded in the console codepage. This would be necessary when communicating with other programs via pipes. # Proposal Make Encoding.find("console") return the encoding that represents the console codepage. # Background(continued) Since Windows 10, UTF-8 support seems to be enhanced in the commandline environment. * build 17134 ucrt supports UTF-8 locale codepage ```setlocale(LC_CTYPE, ".utf8")``` Windows support UTF-8 ANSI Codepage(experimental) ```Beta: Use Unicode UTF-8 for worldwide language support``` * build 18362 support ```Set a process code page to UTF-8``` via manifest. * build 19041 Time zone name holds in wchar_t internaly, so proper tzname can be obtained regardless of the Windows language setting. This should not be all. Through these, I feel that the Microsoft team recommends the use of utf-8. It also seems that Microsoft, which has previously depricated the ANSI version of the API, is treating it as a valid alternative to use in UTF-8. If it becomes widespread on Windows for libraries to respect the C runtime library locale, ruby would do better to follow it. Of course, it is good to be able to get the encoding of the console by specifying a console. # Future plan By reducing differences from other platforms, bugs and extra code are hoped to be reduced. * Do ```setlocale(LC_CTYPE, ".utf8");``` in main.c (or refer LC_* environment variables). * ```Encoding.find("locale")``` returns C runtime library locale. Since strings obtained from the Windows system have a Unicode code range, the API to obtain fixed UTF-8 encoding remains unchanged. # Discussion The code page we can get from Windows also has ACP and OEMCP, but are these necessary? Is it reasonable to get locale_encoding if Encoding.find("console") is called on other platforms? -- https://bugs.ruby-lang.org/ ______________________________________________ ruby-core mailing list -- ruby-core@ml.ruby-lang.org To unsubscribe send an email to ruby-core-leave@ml.ruby-lang.org ruby-core info -- https://ml.ruby-lang.org/mailman3/lists/ruby-core.ml.ruby-lang.org/