WCTYPE

Section: Linux Programmer's Manual (3)
Updated: 2014-01-22
Index Return to Main 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.

Index

Multithreading (see pthreads(7))

CONFORMING TO

NOTES

SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:54:52 GMT, September 18, 2014