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

• Show log

  Commit

• Hash : ef339871
  Author :
  Date : 2020-01-09T16:20:10
  

  c32srtombs: New module.
  
  * lib/uchar.in.h (c32srtombs): New declaration.
  * lib/wcsrtombs-impl.h: Parameterize: Use macros FUNC, SCHAR_T,
  INTERNAL_STATE, WCRTOMB.
  * lib/wcsrtombs.c (FUNC, SCHAR_T, INTERNAL_STATE, WCRTOMB): New macros.
  * lib/c32srtombs.c: New file.
  * lib/c32srtombs-state.c: New file, based on lib/wcsrtombs-state.c.
  * m4/uchar.m4 (gl_UCHAR_H_DEFAULTS): Initialize GNULIB_C32SRTOMBS.
  * modules/uchar (Makefile.am): Substitute GNULIB_C32SRTOMBS.
  * modules/c32srtombs: New file.
  * tests/test-uchar-c++.cc: Test the signature of c32srtombs.
  * doc/posix-functions/wcsrtombs.texi: Mention the new module.
  

Download

• doc/posix-functions/wcsrtombs.texi

• @node wcsrtombs
  @section @code{wcsrtombs}
  @findex wcsrtombs
  
  POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/wcsrtombs.html}
  
  Gnulib module: wcsrtombs
  
  Portability problems fixed by Gnulib:
  @itemize
  @item
  This function is missing on some platforms:
  Minix 3.1.8, HP-UX 11.00, IRIX 6.5, mingw.
  @item
  This function does not ignore the length argument if the destination argument is NULL on some platforms:
  mingw.
  @item
  This function updates the source pointer also if the destination argument is NULL on some platforms:
  HP-UX 11.
  @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{c32srtombs}, provided by Gnulib module
  @code{c32srtombs}, operates on 32-bit wide characters and therefore does not
  have this limitation.
  @end itemize
  

Download