view doc/posix-functions/isdigit.texi @ 12186:f3ad15bb66b0

Document the alternative APIs for character classification.
author Bruno Haible <bruno@clisp.org>
date Sun, 18 Oct 2009 21:49:38 +0200
parents c83dc7e8df57
children bb0ceefd22dc
line wrap: on
line source

@node isdigit
@section @code{isdigit}
@findex isdigit

POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/isdigit.html}

Gnulib module: ---

Portability problems fixed by Gnulib:
@itemize
@end itemize

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_isdigit
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 iswdigit
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_isdigit
This function operates in a locale dependent way, on multibyte characters.
It is provided by the Gnulib module @samp{mbchar}.

@item uc_is_digit
This function operates in a locale independent way, on Unicode characters.
It is provided by the Gnulib module @samp{unictype/ctype-digit}.
@end table