WCTYPE(3C) Standard C Library Functions WCTYPE(3C)

NAME

wctype, wctype_l - define character class

SYNOPSIS

#include <wchar.h>

wctype_t wctype(const char *charclass);

wctype_t wctype_l(const char *charclass, locale_t loc);

DESCRIPTION

The wctype() function is defined for valid character class names as
defined in the current locale. The charclass is a string identifying
a generic character class for which codeset-specific type information
is required. The following character class names are defined in all
locales:

"alnum" "alpha" "blank"
"cntrl" "digit" "graph"
"lower" "print" "punct"
"space" "upper" "xdigit"


Additional character class names defined in the locale definition
file (category LC_CTYPE) can also be specified.

The function returns a value of type wctype_t, which can be used as
the second argument to subsequent calls of iswctype(3C). The wctype()
function determines values of wctype_t according to the rules of the
coded character set defined by character type information in the
current locale (category LC_CTYPE). The values returned by wctype()
are valid only in the locale, or locales with the same LC_CTYPE
category.

The function wctype_l() behaves identically to wctype(), except
instead of operating in the current locale, it operates in the locale
specified by loc.

RETURN VALUES

These functions return 0 if the given character class name is not
valid for the locale (category LC_CTYPE); otherwise it returns an
object of type wctype_t that can be used in calls to iswctype(3C).

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

iswctype(3C), newlocale(3C), setlocale(3C), uselocale(3C),
attributes(7), standards(7)

June 25, 2014 WCTYPE(3C)