[libcxx] Fix the error checking for wctob_l, fixing locale narrow function on Windows
authorMartin Storsjö <martin@martin.st>
Thu, 20 Jan 2022 22:38:52 +0000 (22:38 +0000)
committerMartin Storsjö <martin@martin.st>
Fri, 25 Feb 2022 21:44:23 +0000 (23:44 +0200)
commit0f5d0d4e820ea50e251fb4b6592c02635c49081e
tree1a198ccc78c033ebe28db84e9b99344a9372ac46
parent2d54bf3bc75174b85e437eb94bc4d9de311a7e21
[libcxx] Fix the error checking for wctob_l, fixing locale narrow function on Windows

According to POSIX.1 (and Glibc docs, and Microsoft docs), the wctob
function returns EOF on error, not WEOF. (And wctob_l should consequently
do the same.)

The previous misconception about what this function returns on errors
seems to stem from incorrect documentation in macOS, stemming from BSD
docs with the same issue. The corresponding documentation bug in FreeBSD
was fixed in 2012 in
https://github.com/freebsd/freebsd-src/commit/945aab90991bdaeabeb6ef25112975a96c01dd4e,
but it hasn't been fixed for macOS yet.

The issue seems to only be a documentation issue; the implementation
on macOS actually does use EOF, not WEOF:
https://opensource.apple.com/source/Libc/Libc-1439.40.11/locale/FreeBSD/wctob.c.auto.html

On most Unices, EOF and WEOF are the same value, but on Windows,
EOF is -1, while WEOF is (unsigned short)0xFFFF. By fixing this,
two tests start passing on Windows.

Differential Revision: https://reviews.llvm.org/D120088
libcxx/src/locale.cpp
libcxx/test/std/localization/locale.categories/category.ctype/locale.ctype.byname/narrow_1.pass.cpp
libcxx/test/std/localization/locale.categories/category.ctype/locale.ctype.byname/narrow_many.pass.cpp