doc/posix-functions/isupper.texi

   1 @node isupper
   2 @section @code{isupper}
   3 @findex isupper
   4
   5 POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/isupper.html}
   6
   7 Gnulib module: ctype
   8
   9 Portability problems fixed by Gnulib:
  10 @itemize
  11 @item
  12 This function cannot be called from plain inline or extern inline functions
  13 on some platforms:
  14 OS X 10.8.
  15 @end itemize
  16
  17 Portability problems not fixed by Gnulib:
  18 @itemize
  19 @end itemize
  20
  21 Note: This function's behaviour depends on the locale, but does not support
  22 the multibyte characters that occur in strings in locales with
  23 @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
  24 There are four alternative APIs:
  25
  26 @table @code
  27 @item c_isupper
  28 This function operates in a locale independent way and returns true only for
  29 ASCII characters.  It is provided by the Gnulib module @samp{c-ctype}.
  30
  31 @item iswupper
  32 This function operates in a locale dependent way, on wide characters.  In
  33 order to use it, you first have to convert from multibyte to wide characters,
  34 using the @code{mbrtowc} function.  It is provided by the Gnulib module
  35 @samp{wctype}.
  36
  37 @item mb_isupper
  38 This function operates in a locale dependent way, on multibyte characters.
  39 It is provided by the Gnulib module @samp{mbchar}.
  40
  41 @item uc_is_upper
  42 This function operates in a locale independent way, on Unicode characters.
  43 It is provided by the Gnulib module @samp{unictype/ctype-upper}.
  44 @end table