wctype.3c (2010 09)

w
wctype(3C) wctype(3C)
NAME
wctype(), iswalpha(), iswblank(), iswupper(), iswlower(), iswdigit(), iswxdigit(), iswalnum(), iswspace(),
iswpunct(), iswprint(), iswgraph(), iswcntrl(), iswctype() - classify wide characters
SYNOPSIS
#include <wctype.h>
wctype_t wctype(const char *charclass );
int iswctype(wint_t
wc, wctype_t prop );
int iswalnum(wint_t
wc);
int iswalpha(wint_t
wc);
int iswblank(wint_t
wc);
int iswcntrl(wint_t
wc);
int iswdigit(wint_t
wc);
int iswgraph(wint_t
wc);
int iswlower(wint_t
wc);
int iswprint(wint_t
wc);
int iswpunct(wint_t
wc
);
int iswspace(wint_t wc
);
int iswupper(wint_t
wc);
int iswxdigit(wint_t
wc);
Remarks
These functions are compliant with the XPG4 Worldwide Portability Interface wide-character
classification functions. They parallel the 8-bit character classification functions defined in ctype (3C).
DESCRIPTION
These functions classify wide character values according to the rules of the coded character set identified
by the last successful call to
setlocale() (see setlocale (3C)).
If
setlocale() has not been called successfully, characters are classified according to the rules of the
default ASCII 7-bit coded character set (see setlocale (3C)).
Each of the classification functions is a predicate that returns non-zero for true, zero for false.
wctype() is defined for valid character class names as defined in the current locale. charclass is a
string identifying a generic character class for which codeset-specific type information is required. The
following class names are defined in all locales:
alnum, alpha, blank,
cntrl, digit, graph,
lower, print, punct, space, upper, and xdigit. User-defined class names may be specified if
supported by the current locale as defined by setlocale() (see setlocale (3C)). wctype() returns a
value of type wctype_t that can be used in a subsequent call to iswctype(),or(wctype_t)-1 if
charclass is not valid in the current locale.
The classification functions return non-zero under the following circumstances, and zero otherwise:
iswctype(wc,prop )
wc has the property defined by prop .
iswalpha(wc) wc is a letter.
iswblank(wc) wc is a blank character; that is a space or tab.
iswupper(wc) wc is an uppercase letter.
iswlower(wc) wc is a lowercase letter.
iswdigit(wc) wc is a decimal digit (in ASCII: characters [0-9]).
iswxdigit(wc) wc is a hexadecimal digit (in ASCII: characters [0-9], [A-F] or [a-f]).
iswalnum(wc) wc is an alphanumeric (letters or digits).
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1