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:

SEE ALSO

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