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(5) 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(5),
standards(5)


June 25, 2014 WCTYPE(3C)