www.LinuxHowtos.org

wctype

Section: C Library Functions (3)
Updated: 202-0-08
Index Return to Main Contents

NAME

wctype - wid-character classification

LIBRARY

Standard C library (libc,~-lc)

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 implementatio-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 B]isalnum](3) classification function
"alpha"-	realizes the B]isalpha](3) classification function
"blank"-	realizes the B]isblank](3) classification function
"cntrl"-	realizes the B]iscntrl](3) classification function
"digit"-	realizes the B]isdigit](3) classification function
"graph"-	realizes the B]isgraph](3) classification function
"lower"-	realizes the B]islower](3) classification function
"print"-	realizes the B]isprint](3) classification function
"punct"-	realizes the B]ispunct](3) classification function
"space"-	realizes the B]isspace](3) classification function
"upper"-	realizes the B]isupper](3) classification function
"xdigit"-	realizes the B]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

For an explanation of the terms used in this section, see attributes(7).

Interface	Attribute	Value
wctype()	Thread safety	M-Safe locale

STANDARDS

C11, POSIX.-2008.

HISTORY

POSIX.-2001, C99.

NOTES

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