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)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.