kc3-lang/gnulib/doc/posix-functions/mbstowcs.texi

• Show log

  Commit

• Hash : 7595a881
  Author :
  Date : 2023-03-31T00:27:20
  

  mbstowcs: New module.
  
  * lib/stdlib.in.h (mbstowcs): New declaration.
  * lib/mbstowcs.c: New file, based on lib/mbstoc32s.c.
  * m4/mbstowcs.m4: New file.
  * m4/stdlib_h.m4 (gl_STDLIB_H): Test whether mbstowcs is declared.
  (gl_STDLIB_H_REQUIRE_DEFAULTS): Initialize GNULIB_MBSTOWCS.
  (gl_STDLIB_H_DEFAULTS): Initialize REPLACE_MBSTOWCS.
  * modules/stdlib (Makefile.am): Substitute GNULIB_MBSTOWCS,
  REPLACE_MBSTOWCS.
  * modules/mbstowcs: New file.
  * tests/test-stdlib-c++.cc (mbstowcs): Check signature.
  * doc/posix-functions/mbstowcs.texi: Mention the C locale behaviour bug
  and the new module.
  

Download

• doc/posix-functions/mbstowcs.texi

• @node mbstowcs
  @section @code{mbstowcs}
  @findex mbstowcs
  
  POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/mbstowcs.html}
  
  Gnulib module: mbstowcs
  
  Portability problems fixed by Gnulib:
  @itemize
  @item
  In the C or POSIX locales, this function can return @code{(size_t) -1}
  and set @code{errno} to @code{EILSEQ}:
  glibc 2.35.
  @end itemize
  
  Portability problems not fixed by Gnulib:
  @itemize
  @item
  On Windows and 32-bit AIX platforms, @code{wchar_t} is a 16-bit type and
  therefore cannot accommodate all Unicode characters.
  However, the Gnulib function @code{mbstoc32s}, provided by Gnulib module
  @code{mbstoc32s}, operates on 32-bit wide characters and therefore does not
  have this limitation.
  @end itemize
  

Download