ISWCTYPE(3C) Standard C Library Functions ISWCTYPE(3C)

NAME


iswctype - test character for specified class

SYNOPSIS


#include <wchar.h>

int iswctype(wint_t wc, wctype_t charclass);

int iswctype(wint_t wc, wctype_t charclass, locale_t loc);


DESCRIPTION


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.

RETURN VALUES


These functions return 0 for FALSE and non-zero for TRUE.

USAGE


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.

ATTRIBUTES


See attributes(7) for descriptions of the following attributes:

+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|CSI | Enabled |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO


iswalpha(3C), newlocale(3C), setlocale(3C), uselocale(3C), wctype(3C),
attributes(7), standards(7)

illumos July 26, 2014 ISWCTYPE(3C)