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

• Show log

  Commit

• Hash : adfbfffa
  Author :
  Date : 2024-07-20T20:02:14
  

  doc: Sort the ISO C and POSIX Function Substitutes by header file.
  
  * doc/gnulib.texi (Function Substitutes): Add one section per header
  file.
  * doc/posix-functions/*.texi: Each of these files is now a subsection.
  

Download

• doc/posix-functions/tolower.texi

• @node tolower
  @subsection @code{tolower}
  @findex tolower
  
  POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9799919799/functions/tolower.html}
  
  Gnulib module: ctype
  
  Portability problems fixed by Gnulib:
  @itemize
  @item
  This function cannot be called from plain inline or extern inline functions
  on some platforms:
  macOS 10.8.
  @end itemize
  
  Portability problems not fixed by Gnulib:
  @itemize
  @end itemize
  
  Note: This function's behaviour depends on the locale, but does not support
  the multibyte characters that occur in strings in locales with
  @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
  There are four alternative APIs:
  
  @table @code
  @item c_tolower
  This function operates in a locale independent way and returns a different
  value than the argument only for uppercase ASCII characters.  It is provided
  by the Gnulib module @samp{c-ctype}.
  
  @item towlower
  This function operates in a locale dependent way, on wide characters.  In
  order to use it, you first have to convert from multibyte to wide characters,
  using the @code{mbrtowc} function.  It is provided by the Gnulib module
  @samp{wctype}.
  
  @item c32tolower
  This function operates in a locale dependent way, on 32-bit wide characters.
  In order to use it, you first have to convert from multibyte to 32-bit wide
  characters, using the @code{mbrtoc32} function.  It is provided by the
  Gnulib module @samp{c32tolower}.
  
  @item uc_tolower
  This function operates in a locale independent way, on Unicode characters.
  It is provided by the Gnulib module @samp{unicase/tolower}.
  @end table
  

Download