[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    WCTYPE(3) manual page Table of Contents

Name

wctype - wide-character classification

Synopsis


#include <wctype.h>
wctype_t wctype(const char *name);

Description

The wctype_t type represents a property which a wide character may or may not have. In other words, it represents a class of wide characters. This type’s nature is implementation-dependent, but the special value (wctype_t) 0 denotes an invalid property. Nonzero wctype_t values can be passed to the iswctype(3) function to actually test whether a given wide character has the property.

The wctype() function returns a property, given by its name. The set of valid names depends on the LC_CTYPE category of the current locale, but the following names are valid in all locales. 

  "alnum" - realizes the isalnum(3) classification function
  "alpha" - realizes the isalpha(3) classification function
  "blank" - realizes the isblank(3) classification function
  "cntrl" - realizes the iscntrl(3) classification function
  "digit" - realizes the isdigit(3) classification function
  "graph" - realizes the isgraph(3) classification function
  "lower" - realizes the islower(3) classification function
  "print" - realizes the isprint(3) classification function
  "punct" - realizes the ispunct(3) classification function
  "space" - realizes the isspace(3) classification function
  "upper" - realizes the isupper(3) classification function
  "xdigit" - realizes the isxdigit(3) classification function

Return Value

The wctype() function returns a property descriptor if the name is valid. Otherwise, it returns (wctype_t) 0.

Attributes

Multithreading (see pthreads(7) )

The wctype() function is thread-safe with exceptions. It can be safely used in multithreaded applications, as long as setlocale(3) is not called to change the locale during its execution.

Conforming to

C99.

Notes

The behavior of wctype() depends on the LC_CTYPE category of the current locale.

See Also

iswctype(3)

Colophon

This page is part of release 3.78 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at http://www.kernel.org/doc/man-pages/.

Table of Contents