a6908dd96980f32e78ccbec151bd10815cee8b61
[gnulib.git] / doc / posix-functions / isascii.texi
1 @node isascii
2 @section @code{isascii}
3 @findex isascii
4
5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/isascii.html}
6
7 Gnulib module: ---
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 requires special
22 handling for 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 two alternative APIs:
25
26 @table @code
27 @item c_isascii
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 mb_isascii
32 This function operates in a locale dependent way, on multibyte characters.
33 It is provided by the Gnulib module @samp{mbchar}.
34 @end table