HP-UX Reference (11i v2 04/09) - 3 Library Functions N-Z (vol 7)

w
wctype(3C) wctype(3C)
NAME
iswalpha(), iswupper( ), iswlower( ), iswdigit( ), iswxdigit(), iswalnum( ), iswspace( ), iswpunct( ), isw-
print( ), iswgraph( ), iswcntrl( ), wctype( ), 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 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.
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).
iswspace(wc) wc is a character that creates "white space" in displayed text (in ASCII:space,
tab, carriage return, new-line, vertical tab, and form-feed).
iswpunct(wc) wc is a punctuation character (in ASCII: any printing character except the
space character (040), digits, letters).
iswprint(wc) wc is a printing character.
iswgraph(wc) wc is a visible character (in ASCII: printing characters, excluding the space
character (040)).
Section 3−−1168 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: September 2004