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)

July 26, 2014 ISWCTYPE(3C)