_isctype, iswctype, _isctype_l, _iswctype_l

Tests c for the ctype property specified by the desc argument. For each valid value of desc, there is an equivalent wide-character classification routine.

Syntax

int _isctype(
   int c,
   _ctype_t desc
);
int _isctype_l(
   int c,
   _ctype_t desc,
   _locale_t locale
);
int iswctype(
   wint_t c,
   wctype_t desc
);
int _iswctype_l(
   wint_t c,
   wctype_t desc,
   _locale_t locale
);

Parameters

c
Integer to test.

desc
Property to test for. This is normally retrieved using ctype or wctype.

locale
The locale to use for any locale-dependent tests.

Return Value

_isctype and iswctype return a nonzero value if c has the property specified by desc in the current locale or 0 if it does not. The versions of these functions with the _l suffix are identical except that they use the locale passed in instead of the current locale for their locale-dependent behavior. For more information, see Locale.

The behavior of _isctype and _isctype_l is undefined if c is not EOF or in the range 0 through 0xFF, inclusive. When a debug CRT library is used and c is not one of these values, the functions raise an assertion.

Generic-Text Routine Mappings

Tchar.h routine _UNICODE and _MBCS not defined _MBCS defined _UNICODE defined
n/a _isctype n/a _iswctype
n/a _isctype_l n/a _iswctype_l

Remarks

By default, this function's global state is scoped to the application. To change this, see Global state in the CRT.

Requirements

Routine Required header
_isctype <ctype.h>
iswctype <ctype.h> or <wchar.h>
_isctype_l <ctype.h>
_iswctype_l <ctype.h> or <wchar.h>

For more compatibility information, see Compatibility.

Libraries

All versions of the C run-time libraries.

See also

Character Classification
Locale
is, isw Routines