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)