avoid some overlong lines from posix urls, etc.
[gnulib.git] / doc / posix-functions / isalnum.texi
1 @node isalnum
2 @section @code{isalnum}
3 @findex isalnum
4
5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/isalnum.html}
6
7 Gnulib module: ---
8
9 Portability problems fixed by Gnulib:
10 @itemize
11 @end itemize
12
13 Portability problems not fixed by Gnulib:
14 @itemize
15 @end itemize
16
17 Note: This function's behaviour depends on the locale, but does not support
18 the multibyte characters that occur in strings in locales with
19 @code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales).
20 There are four alternative APIs:
21
22 @table @code
23 @item c_isalnum
24 This function operates in a locale independent way and returns true only for
25 ASCII characters.  It is provided by the Gnulib module @samp{c-ctype}.
26
27 @item iswalnum
28 This function operates in a locale dependent way, on wide characters.  In
29 order to use it, you first have to convert from multibyte to wide characters,
30 using the @code{mbrtowc} function.  It is provided by the Gnulib module
31 @samp{wctype}.
32
33 @item mb_isalnum
34 This function operates in a locale dependent way, on multibyte characters.
35 It is provided by the Gnulib module @samp{mbchar}.
36
37 @item uc_is_alnum
38 This function operates in a locale independent way, on Unicode characters.
39 It is provided by the Gnulib module @samp{unictype/ctype-alnum}.
40 @end table