wctype(3)                                                     wctype(3)

  wctype()

  NAME

    wctype() - define character class

  SYNOPSIS

    #include 

    wctype_t wctype(const char *property)

  DESCRIPTION

    The wctype(3) function is defined for valid character class names as
    defined in the current locale. The property 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" and "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(3). The wctype(3) function
    determines values of wctype_t according to the rules of the coded
    character set defined by character type information in the program's
    locale (category LC_CTYPE). The values returned by wctype(3) are valid
    until a call to setlocale(3). that modifies the category LC_CTYPE.

    The arguments are:

    property
        A pointer to string containing a character class name.

  RETURN VALUES

    If the wctype(3) call is successful it returns an object of type wctype_t
    that can be used in calls to iswctype(3). If the given character class
    name is not valid for the current locale (category LC_CTYPE) the wctype(3)
    call fails and it returns 0.

  ERRORS

    No errors are defined.

  SEE ALSO

    iswctype(3)

  USAGE NOTES

    The wctype function is thread safe.

    The wctype function is not async-signal safe.