c_cpp/lib/gnulib/doc/posix-functions/setlocale.texi

   1 @node setlocale
   2 @section @code{setlocale}
   3 @findex setlocale
   4
   5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/setlocale.html}
   6
   7 Gnulib module: setlocale
   8
   9 Portability problems fixed by Gnulib:
  10 @itemize
  11 @item
  12 On Windows platforms (excluding Cygwin), @code{setlocale(@var{category},NULL)}
  13 ignores the environment variables @code{LC_ALL}, @code{@var{category}}, and
  14 @code{LANG}.
  15 @item
  16 On Windows platforms (excluding Cygwin) and Cygwin 1.5.x,
  17 @code{setlocale(LC_ALL,@var{name})} succeeds and sets the LC_CTYPE category to
  18 @samp{C} when it does not support the encoding, instead of failing.
  19 @item
  20 On Windows platforms (excluding Cygwin), @code{setlocale} understands different
  21 locale names, that are not based on ISO 639 language names and ISO 3166 country
  22 names.
  23 @end itemize
  24
  25 Portability problems not fixed by Gnulib:
  26 @itemize
  27 @item
  28 On Cygwin 1.5.x, which doesn't have locales,
  29 @code{setlocale(LC_ALL,NULL)} always returns @code{"C"}.
  30 @item
  31 On Cygwin 1.7.0, only the charset portion of a locale designation is honored.
  32 @end itemize