poll tests: Avoid test failure on BSD and Solaris systems.
[gnulib.git] / doc / posix-functions / islower.texi
blob8eba57ae5abfff9c2755b0653d5d1045b7910967
1 @node islower
2 @section @code{islower}
3 @findex islower
5 POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/islower.html}
7 Gnulib module: ctype
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
17 Portability problems not fixed by Gnulib:
18 @itemize
19 @end itemize
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:
26 @table @code
27 @item c_islower
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}.
31 @item iswlower
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}.
37 @item mb_islower
38 This function operates in a locale dependent way, on multibyte characters.
39 It is provided by the Gnulib module @samp{mbchar}.
41 @item uc_is_lower
42 This function operates in a locale independent way, on Unicode characters.
43 It is provided by the Gnulib module @samp{unictype/ctype-lower}.
44 @end table