poll tests: Avoid test failure on BSD and Solaris systems.
[gnulib.git] / doc / posix-functions / isblank.texi
blobab23391ac68339c3a6663a06f100f8e6da46b8e8
1 @node isblank
2 @section @code{isblank}
3 @findex isblank
5 POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/isblank.html}
7 Gnulib module: isblank
9 Portability problems fixed by Gnulib:
10 @itemize
11 @item
12 This function is missing on some platforms:
13 IRIX 6.5, Solaris 9, mingw, MSVC 9.
14 @item
15 This function cannot be called from plain inline or extern inline functions
16 on some platforms:
17 OS X 10.8.
18 @end itemize
20 Portability problems not fixed by Gnulib:
21 @itemize
22 @end itemize
24 Note: This function's behaviour depends on the locale, but does not support
25 the multibyte characters that occur in strings in locales with
26 @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
27 There are four alternative APIs:
29 @table @code
30 @item c_isblank
31 This function operates in a locale independent way and returns true only for
32 ASCII characters.  It is provided by the Gnulib module @samp{c-ctype}.
34 @item iswblank
35 This function operates in a locale dependent way, on wide characters.  In
36 order to use it, you first have to convert from multibyte to wide characters,
37 using the @code{mbrtowc} function.  It is provided by the Gnulib module
38 @samp{wctype}.
40 @item mb_isblank
41 This function operates in a locale dependent way, on multibyte characters.
42 It is provided by the Gnulib module @samp{mbchar}.
44 @item uc_is_blank
45 This function operates in a locale independent way, on Unicode characters.
46 It is provided by the Gnulib module @samp{unictype/ctype-blank}.
47 @end table