WCTYPE(3) | Library Functions Manual | WCTYPE(3) |
iswctype
,
iswctype_l
, wctype
,
wctype_l
— wide character
class functions
Standard C Library (libc, -lc)
#include
<wctype.h>
int
iswctype
(wint_t wc,
wctype_t charclass);
wctype_t
wctype
(const char
*property);
#include
<wctype.h>
#include <xlocale.h>
int
iswctype_l
(wint_t wc,
wctype_t charclass, locale_t
loc);
wctype_t
wctype_l
(const char *property,
locale_t loc);
The
wctype
()
function returns a value of type wctype_t, which
represents the requested wide character class and may be used as the second
argument for calls to iswctype
().
The following character class names are recognised:
alnum |
cntrl | ideogram | space | xdigit | |
alpha |
digit | lower | punct | special | |
blank |
graph | phonogram | rune | upper |
The
iswctype
()
function checks whether the wide character wc is in
the character class charclass.
Although the
iswctype
()
and wctype
() functions use the current locale, the
iswctype_l
()
and
wctype_l
()
functions may be passed locales directly. See
xlocale(3) for more information.
The iswctype
() function returns non-zero
if and only if wc has the property described by
charclass, or charclass is
zero.
The wctype
() function returns 0 if
property is invalid; otherwise, it returns a value of
type wctype_t that can be used in subsequent calls to
iswctype
().
Reimplement iswalpha(3) in
terms of iswctype
() and
wctype
():
int myiswalpha(wint_t wc) { return (iswctype(wc, wctype("alpha"))); }
The iswctype
() and
wctype
() functions conform to IEEE
Std 1003.1-2001 (“POSIX.1”). The
“ideogram
”,
“phonogram
”,
“special
”, and
“rune
” character classes are
extensions.
The iswctype
() and
wctype
() functions first appeared in
FreeBSD 5.0.
March 27, 2004 | macOS 14.6 |