Hash :
8c4d0fbf
Author :
Date :
2023-05-16T02:02:13
doc: New chapter "Strings and Characters". * doc/strings.texi: New file. * doc/gnulib.texi (POSIXURL): New variable. (posixheader, posixfunc, func): New macros, from GNU libunistring's documentation. Include strings.texi. (Particular Modules): Don't include c-locale.texi here. * doc/c-locale.texi: Sections become subsections, subsections become subsubsections. * doc/posix-functions/isalnum.texi: Mention c32isalnum. * doc/posix-functions/isalpha.texi: Mention c32isalpha. * doc/posix-functions/isblank.texi: Mention c32isblank. * doc/posix-functions/iscntrl.texi: Mention c32iscntrl. * doc/posix-functions/isdigit.texi: Mention c32isdigit. * doc/posix-functions/isgraph.texi: Mention c32isgraph. * doc/posix-functions/islower.texi: Mention c32islower. * doc/posix-functions/isprint.texi: Mention c32isprint. * doc/posix-functions/ispunct.texi: Mention c32ispunct. * doc/posix-functions/isspace.texi: Mention c32isspace. * doc/posix-functions/isupper.texi: Mention c32isupper. * doc/posix-functions/isxdigit.texi: Mention c32isxdigit. * doc/posix-functions/tolower.texi: Mention alternative APIs. * doc/posix-functions/toupper.texi: Likewise. * doc/posix-functions/towlower.texi: Mention c32tolower. * doc/posix-functions/towupper.texi: Mention c32toupper. * doc/posix-functions/wcswidth.texi: Mention c32swidth. * doc/posix-functions/wcwidth.texi: Mention c32width.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50
@node isspace
@section @code{isspace}
@findex isspace
POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/isspace.html}
Gnulib module: ctype
Portability problems fixed by Gnulib:
@itemize
@item
This function cannot be called from plain inline or extern inline functions
on some platforms:
OS X 10.8.
@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 five alternative APIs:
@table @code
@item c_isspace
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 iswspace
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 c32isspace
This function operates in a locale dependent way, on 32-bit wide characters.
In order to use it, you first have to convert from multibyte to 32-bit wide
characters, using the @code{mbrtoc32} function. It is provided by the
Gnulib module @samp{c32isspace}.
@item mb_isspace
This function operates in a locale dependent way, on multibyte characters.
It is provided by the Gnulib module @samp{mbchar}.
@item uc_is_space
This function operates in a locale independent way, on Unicode characters.
It is provided by the Gnulib module @samp{unictype/ctype-space}.
@end table