Hello Bruno,
On 7/4/21 12:26 PM, Bruno Haible wrote:
mbrtoc32, c32rtomb \- convert between multibyte sequence and 32-bit wide character
I would suggest two separate man pages for these functions.
Rationale:
It is rare that some code uses mbrtoc32 and c32rtomb in the same function.
(Basically, functions that do input call mbrtoc32, and functions that do
output call c32rtomb.) And the description of mbrtoc32 is a bit complex.
Okay. Indeed, the *wc* functions are documented separately.
Are there any important differences compared to the already-documented
and C99-compliant mbrtowc(3) and wcrtomb(3)? I mean, apart from the
types of the parameters. >
No for c32rtomb, but yes for mbrtoc32: mbrtowc has the special return
values (size_t)-1 and (size_t)-2, whereas mbrtoc32 also has the special
return value (size_t)-3. Although, on glibc currently this special
return value (size_t)-3 cannot occur. But IMO the man page should
mention it nevertheless, otherwise people write code that is not
future-proof.
Thanks for those details!
Regards,
Alex
--
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/
