X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Fposix-functions%2Fisalpha.texi;h=dcff8e8cda57c7195fbf70c6f74f5ff3a86f62b2;hb=14b6d70139486b63e66257aad1abe2a9615f4d96;hp=4ba099796aac7a23962e6ccb44a5ebc7a511b783;hpb=09ef7461110822a3970aa8eebcfaa740996a82f2;p=gnulib.git diff --git a/doc/posix-functions/isalpha.texi b/doc/posix-functions/isalpha.texi index 4ba099796..dcff8e8cd 100644 --- a/doc/posix-functions/isalpha.texi +++ b/doc/posix-functions/isalpha.texi @@ -2,7 +2,7 @@ @section @code{isalpha} @findex isalpha -POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/isalpha.html} +POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/isalpha.html} Gnulib module: --- @@ -13,3 +13,28 @@ Portability problems fixed by Gnulib: Portability problems not fixed by Gnulib: @itemize @end itemize + +Note: This function's behaviour depends on the locale, but does not support +the multibyte characters that occur in strings in locales with +@code{MB_CUR_MAX > 1} (this includes all the common UTF-8 locales). +There are four alternative APIs: + +@table @code +@item c_isalpha +This function operates in a locale independent way and returns true only for +ASCII characters. It is provided by the Gnulib module @samp{c-ctype}. + +@item iswalpha +This function operates in a locale dependent way, on wide characters. In +order to use it, you first have to convert from multibyte to wide characters, +using the @code{mbrtowc} function. It is provided by the Gnulib module +@samp{wctype}. + +@item mb_isalpha +This function operates in a locale dependent way, on multibyte characters. +It is provided by the Gnulib module @samp{mbchar}. + +@item uc_is_alpha +This function operates in a locale independent way, on Unicode characters. +It is provided by the Gnulib module @samp{unictype/ctype-alpha}. +@end table