| ISWCTYPE(3C) | Standard C Library Functions | ISWCTYPE(3C) |
iswctype - test character for specified class
#include <wchar.h> int iswctype(wint_t wc, wctype_t charclass);
int iswctype(wint_t wc, wctype_t charclass, locale_t loc);
The iswctype() and iswctype_l() functions determine whether the wide-character code wc is a member of the character class charclass, returning TRUE or FALSE. These functions are defined on WEOF and wide-character codes corresponding to the valid character encodings in the current locale (or loc for iswctype_l().) If the wc argument is not in the domain of the function, the result is undefined. If the value of charclass is invalid (that is, not obtained by a call to wctype (3C) or obtained from a different locale), the result is indeterminate.
Whereas iswctype() operates in the current locale, iswctype_l() operates in the locale specified with loc.
These functions return 0 for FALSE and non-zero for TRUE.
There are twelve strings that are reserved for the standard character classes:
| "alnum" | "alpha" | "blank" |
| "cntrl" | "digit" | "graph" |
| "lower" | "print" | "punct" |
| "space" | "upper" | "xdigit" |
In the table below, the functions in the left column are equivalent to the functions in the right column.
| iswalnum(wc) | iswctype(wc, wctype("alnum")) |
| iswalpha(wc) | iswctype(wc, wctype("alpha")) |
| iswcntrl(wc) | iswctype(wc, wctype("cntrl")) |
| iswdigit(wc) | iswctype(wc, wctype("digit")) |
| iswgraph(wc) | iswctype(wc, wctype("graph")) |
| iswlower(wc) | iswctype(wc, wctype("lower")) |
| iswprint(wc) | iswctype(wc, wctype("print")) |
| iswpunct(wc) | iswctype(wc, wctype("punct")) |
| iswspace(wc) | iswctype(wc, wctype("space")) |
| iswupper(wc) | iswctype(wc, wctype("upper")) |
| iswxdigit(wc) | iswctype(wc, wctype("xdigit")) |
The call
iswctype(wc, wctype("blank"))
does not have an equivalent isw*() function.
See attributes(7) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| CSI | Enabled |
| Interface Stability | Standard |
| MT-Level | MT-Safe |
iswalpha(3C), newlocale(3C), setlocale(3C), uselocale(3C), wctype(3C), attributes(7), standards(7)
| July 26, 2014 | OmniOS |