DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

wctype(3C)


wctype: iswalpha, iswupper, iswlower, iswdigit, iswxdigit, iswalnum, iswgraph, iswspace, iswpunct, iswprint, iswcntrl -- test wide characters for a specified class

Synopsis

   #include <wchar.h>
   

int iswalpha(wint_t wc);

int iswupper(wint_t wc);

int iswlower(wint_t wc);

int iswdigit(wint_t wc);

int iswxdigit(wint_t wc);

int iswalnum(wint_t wc);

int iswspace(wint_t wc);

int iswpunct(wint_t wc);

int iswprint(wint_t wc);

int iswgraph(wint_t wc);

int iswcntrl(wint_t wc);

Description

The isw* functions tests whether wc is a wide-character code representing a character belonging to a particular class in the program's current locale. The LC_CTYPE category defines character class, case conversion, and other character attributes for a locale.

Each function operates on a particluar class of wide characters, as shown in the table below.

iswalnum(wc) wc is an alphanumeric wide character.
iswalpha(wc) wc is an alphabetic wide character.
iswcntrlwc wc is a control characters (not printable)
iswdigit(wc) wc is a wide character representing a digit.
iswgraph(wc) wc is a wide character representing a printable character, but does not include any white space.
iswlower(wc) wc is a lowercase wide character.
iswprint(wc) wc is a wide character representing a printing character including white space.
iswpunct(wc) wc is a wide character representing a punctuation character.
iswspace(wc) wc is a wide character representing a white space character.
iswupper(wc) wc is an uppercase wide character.
iswxdigit(wc) wc is a wide character representing a hexadecimal digit.

 iswalnum(wc)    wc is an alphanumeric wide character.
 iswalpha(wc)    wc is an alphabetic wide character.
 iswcntrlwc      wc is a control characters (not printable)
 iswdigit(wc)    wc is a wide character representing a digit.
 iswgraph(wc)    wc is a wide character representing a printable
                 character, but does not include any white space.
 iswlower(wc)    wc is a lowercase wide character.
 iswprint(wc)    wc is a wide character representing a printing character
                 including white space.
 iswpunct(wc)    wc is a wide character representing a punctuation
                 character.
 iswspace(wc)    wc is a wide character representing a white space
                 character.
 iswupper(wc)    wc is an uppercase wide character.
 iswxdigit(wc)   wc is a wide character representing a hexadecimal digit.

In all cases wc is a wint_t, the value of which must be a wide-character code corresponding to a valid character in the current locale or must equal the value of the macro WEOF.

Return value

These functions returns non-zero if wc is a wide-character code of the appropriate class; otherwise they return 0.

Usage

To ensure application portability, especially across natural languages, only these functions should be used for classification of wide-character codes.

References

locale(1), localedef(1), iswctype(3C), setlocale(3C), wchar(5)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004