function
<cwctype>

iswctype

int iswctype(wint_t c, wctype_t desc);
Check if wide character has property
Checks whether c has the property specified by desc.

A specific locale can accept multiple categories in which to classify its characters. At least the following categories are recognized by all locales:

string passed to wctypedescriptionequivalent function
"alnum"alphanumerical characteriswalnum
"alpha"letter characteriswalpha
"blank"blank characteriswblank
"cntrl"control characteriswcntrl
"digit"decimal digit characteriswdigit
"graph"character with graphical representationiswgraph
"lower"lowercase letter characteriswlower
"print"printable characteriswprint
"punct"punctuation characteriswpunct
"space"white-space characteriswspace
"upper"uppercase letter characteriswupper
"xdigit"hexadecimal digit characteriswxdigit

The setting of the LC_CTYPE locale category at the time of calling the function shall be the same as when wctype was called to obtain desc.

Parameters

c
Wide character to be checked, casted to a wint_t, or WEOF.
wint_t is an integral type.
desc
A value returned by a call to wctype (with the same LC_CTYPE locale category selected as in this call).
wctype_t is the scalar type used as return type for wctype.

Return Value

A value different from zero (i.e., true) if indeed c is has the property identified by desc. Zero (i.e., false) otherwise.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
/* iswctype example */
#include <stdio.h>
#include <wctype.h>
int main ()
{
  int i=0;
  wchar_t str[] = L"Test String.\n";
  wchar_t c;
  wctype_t check = wctype("lower");
  wctrans_t trans = wctrans("toupper");
  while (str[i])
  {
    c = str[i];
    if (iswctype(c,check)) c = towctrans(c,trans);
    putwchar (c);
    i++;
  }
  return 0;
}

Output:
TEST STRING.


See also